atk 0.90.5-x86-mingw32 → 0.90.6-x86-mingw32

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (765) hide show
  1. data/ChangeLog +9 -0
  2. data/Rakefile +8 -70
  3. data/ext/atk/Makefile +160 -0
  4. data/ext/atk/extconf.rb +9 -9
  5. data/ext/atk/rbatkversion.h +24 -0
  6. data/lib/1.8/atk.so +0 -0
  7. data/lib/1.9/atk.so +0 -0
  8. data/vendor/local/lib/pkgconfig/atk.pc +1 -1
  9. metadata +150 -902
  10. data/vendor/local/bin/envsubst.exe +0 -0
  11. data/vendor/local/bin/gettext.exe +0 -0
  12. data/vendor/local/bin/gettext.sh +0 -123
  13. data/vendor/local/bin/glib-genmarshal.exe +0 -0
  14. data/vendor/local/bin/glib-gettextize +0 -188
  15. data/vendor/local/bin/glib-mkenums +0 -537
  16. data/vendor/local/bin/gobject-query.exe +0 -0
  17. data/vendor/local/bin/gspawn-win32-helper-console.exe +0 -0
  18. data/vendor/local/bin/gspawn-win32-helper.exe +0 -0
  19. data/vendor/local/bin/intl.dll +0 -0
  20. data/vendor/local/bin/libasprintf-0.dll +0 -0
  21. data/vendor/local/bin/libgcc_s_dw2-1.dll +0 -0
  22. data/vendor/local/bin/libgio-2.0-0.dll +0 -0
  23. data/vendor/local/bin/libglib-2.0-0.dll +0 -0
  24. data/vendor/local/bin/libgmodule-2.0-0.dll +0 -0
  25. data/vendor/local/bin/libgobject-2.0-0.dll +0 -0
  26. data/vendor/local/bin/libgthread-2.0-0.dll +0 -0
  27. data/vendor/local/bin/ngettext.exe +0 -0
  28. data/vendor/local/include/autosprintf.h +0 -66
  29. data/vendor/local/include/glib-2.0/gio/gappinfo.h +0 -236
  30. data/vendor/local/include/glib-2.0/gio/gasyncinitable.h +0 -119
  31. data/vendor/local/include/glib-2.0/gio/gasyncresult.h +0 -73
  32. data/vendor/local/include/glib-2.0/gio/gbufferedinputstream.h +0 -123
  33. data/vendor/local/include/glib-2.0/gio/gbufferedoutputstream.h +0 -81
  34. data/vendor/local/include/glib-2.0/gio/gcancellable.h +0 -103
  35. data/vendor/local/include/glib-2.0/gio/gcharsetconverter.h +0 -60
  36. data/vendor/local/include/glib-2.0/gio/gcontenttype.h +0 -57
  37. data/vendor/local/include/glib-2.0/gio/gconverter.h +0 -95
  38. data/vendor/local/include/glib-2.0/gio/gconverterinputstream.h +0 -79
  39. data/vendor/local/include/glib-2.0/gio/gconverteroutputstream.h +0 -79
  40. data/vendor/local/include/glib-2.0/gio/gcredentials.h +0 -76
  41. data/vendor/local/include/glib-2.0/gio/gdatainputstream.h +0 -150
  42. data/vendor/local/include/glib-2.0/gio/gdataoutputstream.h +0 -115
  43. data/vendor/local/include/glib-2.0/gio/gdbusaddress.h +0 -58
  44. data/vendor/local/include/glib-2.0/gio/gdbusauthobserver.h +0 -46
  45. data/vendor/local/include/glib-2.0/gio/gdbusconnection.h +0 -562
  46. data/vendor/local/include/glib-2.0/gio/gdbuserror.h +0 -100
  47. data/vendor/local/include/glib-2.0/gio/gdbusintrospection.h +0 -286
  48. data/vendor/local/include/glib-2.0/gio/gdbusmessage.h +0 -149
  49. data/vendor/local/include/glib-2.0/gio/gdbusmethodinvocation.h +0 -73
  50. data/vendor/local/include/glib-2.0/gio/gdbusnameowning.h +0 -112
  51. data/vendor/local/include/glib-2.0/gio/gdbusnamewatching.h +0 -94
  52. data/vendor/local/include/glib-2.0/gio/gdbusproxy.h +0 -167
  53. data/vendor/local/include/glib-2.0/gio/gdbusserver.h +0 -54
  54. data/vendor/local/include/glib-2.0/gio/gdbusutils.h +0 -44
  55. data/vendor/local/include/glib-2.0/gio/gdrive.h +0 -225
  56. data/vendor/local/include/glib-2.0/gio/gemblem.h +0 -58
  57. data/vendor/local/include/glib-2.0/gio/gemblemedicon.h +0 -62
  58. data/vendor/local/include/glib-2.0/gio/gfile.h +0 -1017
  59. data/vendor/local/include/glib-2.0/gio/gfileattribute.h +0 -77
  60. data/vendor/local/include/glib-2.0/gio/gfileenumerator.h +0 -132
  61. data/vendor/local/include/glib-2.0/gio/gfileicon.h +0 -56
  62. data/vendor/local/include/glib-2.0/gio/gfileinfo.h +0 -952
  63. data/vendor/local/include/glib-2.0/gio/gfileinputstream.h +0 -112
  64. data/vendor/local/include/glib-2.0/gio/gfileiostream.h +0 -118
  65. data/vendor/local/include/glib-2.0/gio/gfilemonitor.h +0 -95
  66. data/vendor/local/include/glib-2.0/gio/gfilenamecompleter.h +0 -76
  67. data/vendor/local/include/glib-2.0/gio/gfileoutputstream.h +0 -119
  68. data/vendor/local/include/glib-2.0/gio/gfilterinputstream.h +0 -76
  69. data/vendor/local/include/glib-2.0/gio/gfilteroutputstream.h +0 -76
  70. data/vendor/local/include/glib-2.0/gio/gicon.h +0 -91
  71. data/vendor/local/include/glib-2.0/gio/ginetaddress.h +0 -103
  72. data/vendor/local/include/glib-2.0/gio/ginetsocketaddress.h +0 -69
  73. data/vendor/local/include/glib-2.0/gio/ginitable.h +0 -96
  74. data/vendor/local/include/glib-2.0/gio/ginputstream.h +0 -172
  75. data/vendor/local/include/glib-2.0/gio/gio.h +0 -122
  76. data/vendor/local/include/glib-2.0/gio/gioenums.h +0 -1221
  77. data/vendor/local/include/glib-2.0/gio/gioenumtypes.h +0 -121
  78. data/vendor/local/include/glib-2.0/gio/gioerror.h +0 -52
  79. data/vendor/local/include/glib-2.0/gio/giomodule.h +0 -132
  80. data/vendor/local/include/glib-2.0/gio/gioscheduler.h +0 -52
  81. data/vendor/local/include/glib-2.0/gio/giostream.h +0 -112
  82. data/vendor/local/include/glib-2.0/gio/giotypes.h +0 -375
  83. data/vendor/local/include/glib-2.0/gio/gloadableicon.h +0 -97
  84. data/vendor/local/include/glib-2.0/gio/gmemoryinputstream.h +0 -82
  85. data/vendor/local/include/glib-2.0/gio/gmemoryoutputstream.h +0 -98
  86. data/vendor/local/include/glib-2.0/gio/gmount.h +0 -242
  87. data/vendor/local/include/glib-2.0/gio/gmountoperation.h +0 -123
  88. data/vendor/local/include/glib-2.0/gio/gnativevolumemonitor.h +0 -62
  89. data/vendor/local/include/glib-2.0/gio/gnetworkaddress.h +0 -73
  90. data/vendor/local/include/glib-2.0/gio/gnetworkservice.h +0 -71
  91. data/vendor/local/include/glib-2.0/gio/goutputstream.h +0 -207
  92. data/vendor/local/include/glib-2.0/gio/gpermission.h +0 -118
  93. data/vendor/local/include/glib-2.0/gio/gproxy.h +0 -123
  94. data/vendor/local/include/glib-2.0/gio/gproxyaddress.h +0 -76
  95. data/vendor/local/include/glib-2.0/gio/gproxyaddressenumerator.h +0 -75
  96. data/vendor/local/include/glib-2.0/gio/gproxyresolver.h +0 -96
  97. data/vendor/local/include/glib-2.0/gio/gresolver.h +0 -167
  98. data/vendor/local/include/glib-2.0/gio/gseekable.h +0 -99
  99. data/vendor/local/include/glib-2.0/gio/gsettings.h +0 -258
  100. data/vendor/local/include/glib-2.0/gio/gsettingsbackend.h +0 -138
  101. data/vendor/local/include/glib-2.0/gio/gsimpleasyncresult.h +0 -125
  102. data/vendor/local/include/glib-2.0/gio/gsimplepermission.h +0 -45
  103. data/vendor/local/include/glib-2.0/gio/gsocket.h +0 -194
  104. data/vendor/local/include/glib-2.0/gio/gsocketaddress.h +0 -79
  105. data/vendor/local/include/glib-2.0/gio/gsocketaddressenumerator.h +0 -89
  106. data/vendor/local/include/glib-2.0/gio/gsocketclient.h +0 -152
  107. data/vendor/local/include/glib-2.0/gio/gsocketconnectable.h +0 -74
  108. data/vendor/local/include/glib-2.0/gio/gsocketconnection.h +0 -91
  109. data/vendor/local/include/glib-2.0/gio/gsocketcontrolmessage.h +0 -105
  110. data/vendor/local/include/glib-2.0/gio/gsocketlistener.h +0 -138
  111. data/vendor/local/include/glib-2.0/gio/gsocketservice.h +0 -88
  112. data/vendor/local/include/glib-2.0/gio/gsrvtarget.h +0 -52
  113. data/vendor/local/include/glib-2.0/gio/gtcpconnection.h +0 -68
  114. data/vendor/local/include/glib-2.0/gio/gthemedicon.h +0 -63
  115. data/vendor/local/include/glib-2.0/gio/gthreadedsocketservice.h +0 -81
  116. data/vendor/local/include/glib-2.0/gio/gvfs.h +0 -125
  117. data/vendor/local/include/glib-2.0/gio/gvolume.h +0 -211
  118. data/vendor/local/include/glib-2.0/gio/gvolumemonitor.h +0 -150
  119. data/vendor/local/include/glib-2.0/gio/gzlibcompressor.h +0 -60
  120. data/vendor/local/include/glib-2.0/gio/gzlibdecompressor.h +0 -57
  121. data/vendor/local/include/glib-2.0/glib-object.h +0 -42
  122. data/vendor/local/include/glib-2.0/glib.h +0 -99
  123. data/vendor/local/include/glib-2.0/glib/galloca.h +0 -110
  124. data/vendor/local/include/glib-2.0/glib/garray.h +0 -179
  125. data/vendor/local/include/glib-2.0/glib/gasyncqueue.h +0 -120
  126. data/vendor/local/include/glib-2.0/glib/gatomic.h +0 -105
  127. data/vendor/local/include/glib-2.0/glib/gbacktrace.h +0 -68
  128. data/vendor/local/include/glib-2.0/glib/gbase64.h +0 -57
  129. data/vendor/local/include/glib-2.0/glib/gbitlock.h +0 -43
  130. data/vendor/local/include/glib-2.0/glib/gbookmarkfile.h +0 -215
  131. data/vendor/local/include/glib-2.0/glib/gcache.h +0 -69
  132. data/vendor/local/include/glib-2.0/glib/gchecksum.h +0 -86
  133. data/vendor/local/include/glib-2.0/glib/gcompletion.h +0 -81
  134. data/vendor/local/include/glib-2.0/glib/gconvert.h +0 -162
  135. data/vendor/local/include/glib-2.0/glib/gdataset.h +0 -122
  136. data/vendor/local/include/glib-2.0/glib/gdate.h +0 -263
  137. data/vendor/local/include/glib-2.0/glib/gdatetime.h +0 -217
  138. data/vendor/local/include/glib-2.0/glib/gdir.h +0 -52
  139. data/vendor/local/include/glib-2.0/glib/gerror.h +0 -98
  140. data/vendor/local/include/glib-2.0/glib/gfileutils.h +0 -128
  141. data/vendor/local/include/glib-2.0/glib/ghash.h +0 -166
  142. data/vendor/local/include/glib-2.0/glib/ghook.h +0 -181
  143. data/vendor/local/include/glib-2.0/glib/ghostutils.h +0 -40
  144. data/vendor/local/include/glib-2.0/glib/gi18n-lib.h +0 -38
  145. data/vendor/local/include/glib-2.0/glib/gi18n.h +0 -34
  146. data/vendor/local/include/glib-2.0/glib/giochannel.h +0 -366
  147. data/vendor/local/include/glib-2.0/glib/gkeyfile.h +0 -266
  148. data/vendor/local/include/glib-2.0/glib/glist.h +0 -120
  149. data/vendor/local/include/glib-2.0/glib/gmacros.h +0 -284
  150. data/vendor/local/include/glib-2.0/glib/gmain.h +0 -531
  151. data/vendor/local/include/glib-2.0/glib/gmappedfile.h +0 -49
  152. data/vendor/local/include/glib-2.0/glib/gmarkup.h +0 -163
  153. data/vendor/local/include/glib-2.0/glib/gmem.h +0 -309
  154. data/vendor/local/include/glib-2.0/glib/gmessages.h +0 -343
  155. data/vendor/local/include/glib-2.0/glib/gnode.h +0 -290
  156. data/vendor/local/include/glib-2.0/glib/goption.h +0 -370
  157. data/vendor/local/include/glib-2.0/glib/gpattern.h +0 -49
  158. data/vendor/local/include/glib-2.0/glib/gpoll.h +0 -117
  159. data/vendor/local/include/glib-2.0/glib/gprimes.h +0 -51
  160. data/vendor/local/include/glib-2.0/glib/gprintf.h +0 -52
  161. data/vendor/local/include/glib-2.0/glib/gqsort.h +0 -46
  162. data/vendor/local/include/glib-2.0/glib/gquark.h +0 -52
  163. data/vendor/local/include/glib-2.0/glib/gqueue.h +0 -127
  164. data/vendor/local/include/glib-2.0/glib/grand.h +0 -85
  165. data/vendor/local/include/glib-2.0/glib/gregex.h +0 -471
  166. data/vendor/local/include/glib-2.0/glib/grel.h +0 -101
  167. data/vendor/local/include/glib-2.0/glib/gscanner.h +0 -278
  168. data/vendor/local/include/glib-2.0/glib/gsequence.h +0 -128
  169. data/vendor/local/include/glib-2.0/glib/gshell.h +0 -55
  170. data/vendor/local/include/glib-2.0/glib/gslice.h +0 -86
  171. data/vendor/local/include/glib-2.0/glib/gslist.h +0 -114
  172. data/vendor/local/include/glib-2.0/glib/gspawn.h +0 -139
  173. data/vendor/local/include/glib-2.0/glib/gstdio.h +0 -147
  174. data/vendor/local/include/glib-2.0/glib/gstrfuncs.h +0 -269
  175. data/vendor/local/include/glib-2.0/glib/gstring.h +0 -178
  176. data/vendor/local/include/glib-2.0/glib/gtestutils.h +0 -297
  177. data/vendor/local/include/glib-2.0/glib/gthread.h +0 -407
  178. data/vendor/local/include/glib-2.0/glib/gthreadpool.h +0 -114
  179. data/vendor/local/include/glib-2.0/glib/gtimer.h +0 -65
  180. data/vendor/local/include/glib-2.0/glib/gtimezone.h +0 -44
  181. data/vendor/local/include/glib-2.0/glib/gtree.h +0 -91
  182. data/vendor/local/include/glib-2.0/glib/gtypes.h +0 -451
  183. data/vendor/local/include/glib-2.0/glib/gunicode.h +0 -421
  184. data/vendor/local/include/glib-2.0/glib/gurifuncs.h +0 -81
  185. data/vendor/local/include/glib-2.0/glib/gutils.h +0 -490
  186. data/vendor/local/include/glib-2.0/glib/gvariant.h +0 -248
  187. data/vendor/local/include/glib-2.0/glib/gvarianttype.h +0 -334
  188. data/vendor/local/include/glib-2.0/glib/gwin32.h +0 -114
  189. data/vendor/local/include/glib-2.0/gmodule.h +0 -101
  190. data/vendor/local/include/glib-2.0/gobject/gbinding.h +0 -136
  191. data/vendor/local/include/glib-2.0/gobject/gboxed.h +0 -248
  192. data/vendor/local/include/glib-2.0/gobject/gclosure.h +0 -251
  193. data/vendor/local/include/glib-2.0/gobject/genums.h +0 -261
  194. data/vendor/local/include/glib-2.0/gobject/gmarshal.h +0 -186
  195. data/vendor/local/include/glib-2.0/gobject/gobject.h +0 -567
  196. data/vendor/local/include/glib-2.0/gobject/gobjectnotifyqueue.c +0 -193
  197. data/vendor/local/include/glib-2.0/gobject/gparam.h +0 -415
  198. data/vendor/local/include/glib-2.0/gobject/gparamspecs.h +0 -1137
  199. data/vendor/local/include/glib-2.0/gobject/gsignal.h +0 -509
  200. data/vendor/local/include/glib-2.0/gobject/gsourceclosure.h +0 -51
  201. data/vendor/local/include/glib-2.0/gobject/gtype.h +0 -1736
  202. data/vendor/local/include/glib-2.0/gobject/gtypemodule.h +0 -263
  203. data/vendor/local/include/glib-2.0/gobject/gtypeplugin.h +0 -134
  204. data/vendor/local/include/glib-2.0/gobject/gvalue.h +0 -159
  205. data/vendor/local/include/glib-2.0/gobject/gvaluearray.h +0 -77
  206. data/vendor/local/include/glib-2.0/gobject/gvaluecollector.h +0 -227
  207. data/vendor/local/include/glib-2.0/gobject/gvaluetypes.h +0 -260
  208. data/vendor/local/include/libintl.h +0 -464
  209. data/vendor/local/lib/GNU.Gettext.dll +0 -0
  210. data/vendor/local/lib/gio-2.0.def +0 -1143
  211. data/vendor/local/lib/gio-2.0.lib +0 -0
  212. data/vendor/local/lib/glib-2.0.def +0 -1452
  213. data/vendor/local/lib/glib-2.0.lib +0 -0
  214. data/vendor/local/lib/glib-2.0/include/glibconfig.h +0 -284
  215. data/vendor/local/lib/gmodule-2.0.def +0 -11
  216. data/vendor/local/lib/gmodule-2.0.lib +0 -0
  217. data/vendor/local/lib/gobject-2.0.def +0 -370
  218. data/vendor/local/lib/gobject-2.0.lib +0 -0
  219. data/vendor/local/lib/gthread-2.0.def +0 -3
  220. data/vendor/local/lib/gthread-2.0.lib +0 -0
  221. data/vendor/local/lib/intl.lib +0 -0
  222. data/vendor/local/lib/libasprintf.dll.a +0 -0
  223. data/vendor/local/lib/libgio-2.0.dll.a +0 -0
  224. data/vendor/local/lib/libglib-2.0.dll.a +0 -0
  225. data/vendor/local/lib/libgmodule-2.0.dll.a +0 -0
  226. data/vendor/local/lib/libgobject-2.0.dll.a +0 -0
  227. data/vendor/local/lib/libgthread-2.0.dll.a +0 -0
  228. data/vendor/local/lib/libintl.def +0 -31
  229. data/vendor/local/lib/libintl.dll.a +0 -0
  230. data/vendor/local/lib/pkgconfig/gio-2.0.pc +0 -15
  231. data/vendor/local/lib/pkgconfig/gio-windows-2.0.pc +0 -11
  232. data/vendor/local/lib/pkgconfig/glib-2.0.pc +0 -15
  233. data/vendor/local/lib/pkgconfig/gmodule-2.0.pc +0 -14
  234. data/vendor/local/lib/pkgconfig/gmodule-no-export-2.0.pc +0 -14
  235. data/vendor/local/lib/pkgconfig/gobject-2.0.pc +0 -11
  236. data/vendor/local/lib/pkgconfig/gthread-2.0.pc +0 -11
  237. data/vendor/local/manifest/gettext-runtime-dev_0.18.1.1-2_win32.mft +0 -81
  238. data/vendor/local/manifest/gettext-runtime_0.18.1.1-2_win32.mft +0 -3
  239. data/vendor/local/manifest/glib-dev_2.26.0-2_win32.mft +0 -570
  240. data/vendor/local/manifest/glib_2.26.0-2_win32.mft +0 -102
  241. data/vendor/local/share/aclocal/glib-2.0.m4 +0 -211
  242. data/vendor/local/share/aclocal/glib-gettext.m4 +0 -432
  243. data/vendor/local/share/doc/gettext/bind_textdomain_codeset.3.html +0 -165
  244. data/vendor/local/share/doc/gettext/bindtextdomain.3.html +0 -160
  245. data/vendor/local/share/doc/gettext/csharpdoc/GNU_Gettext.html +0 -8
  246. data/vendor/local/share/doc/gettext/csharpdoc/GNU_Gettext_GettextResourceManager.html +0 -305
  247. data/vendor/local/share/doc/gettext/csharpdoc/GNU_Gettext_GettextResourceSet.html +0 -356
  248. data/vendor/local/share/doc/gettext/csharpdoc/begin.html +0 -11
  249. data/vendor/local/share/doc/gettext/csharpdoc/index.html +0 -10
  250. data/vendor/local/share/doc/gettext/csharpdoc/namespaces.html +0 -6
  251. data/vendor/local/share/doc/gettext/envsubst.1.html +0 -213
  252. data/vendor/local/share/doc/gettext/gettext.1.html +0 -266
  253. data/vendor/local/share/doc/gettext/gettext.3.html +0 -186
  254. data/vendor/local/share/doc/gettext/ngettext.1.html +0 -280
  255. data/vendor/local/share/doc/gettext/ngettext.3.html +0 -143
  256. data/vendor/local/share/doc/gettext/textdomain.3.html +0 -150
  257. data/vendor/local/share/doc/glib-2.26.0/COPYING +0 -482
  258. data/vendor/local/share/doc/glib-dev-2.26.0/COPYING +0 -482
  259. data/vendor/local/share/doc/libasprintf/autosprintf_all.html +0 -174
  260. data/vendor/local/share/glib-2.0/gdb/glib.py +0 -249
  261. data/vendor/local/share/glib-2.0/gdb/gobject.py +0 -305
  262. data/vendor/local/share/glib-2.0/gettext/mkinstalldirs +0 -111
  263. data/vendor/local/share/glib-2.0/gettext/po/Makefile.in.in +0 -279
  264. data/vendor/local/share/glib-2.0/schemas/gschema.dtd +0 -60
  265. data/vendor/local/share/gtk-doc/html/gio/GAppInfo.html +0 -1403
  266. data/vendor/local/share/gtk-doc/html/gio/GAsyncInitable.html +0 -733
  267. data/vendor/local/share/gtk-doc/html/gio/GAsyncResult.html +0 -343
  268. data/vendor/local/share/gtk-doc/html/gio/GBufferedInputStream.html +0 -563
  269. data/vendor/local/share/gtk-doc/html/gio/GBufferedOutputStream.html +0 -291
  270. data/vendor/local/share/gtk-doc/html/gio/GCancellable.html +0 -620
  271. data/vendor/local/share/gtk-doc/html/gio/GCharsetConverter.html +0 -245
  272. data/vendor/local/share/gtk-doc/html/gio/GConverter.html +0 -423
  273. data/vendor/local/share/gtk-doc/html/gio/GCredentials.html +0 -398
  274. data/vendor/local/share/gtk-doc/html/gio/GDBusAuthObserver.html +0 -254
  275. data/vendor/local/share/gtk-doc/html/gio/GDBusConnection.html +0 -6211
  276. data/vendor/local/share/gtk-doc/html/gio/GDBusMessage.html +0 -1833
  277. data/vendor/local/share/gtk-doc/html/gio/GDBusMethodInvocation.html +0 -618
  278. data/vendor/local/share/gtk-doc/html/gio/GDBusProxy.html +0 -2050
  279. data/vendor/local/share/gtk-doc/html/gio/GDBusServer.html +0 -1124
  280. data/vendor/local/share/gtk-doc/html/gio/GDataInputStream.html +0 -1215
  281. data/vendor/local/share/gtk-doc/html/gio/GDataOutputStream.html +0 -540
  282. data/vendor/local/share/gtk-doc/html/gio/GDrive.html +0 -1416
  283. data/vendor/local/share/gtk-doc/html/gio/GEmblem.html +0 -272
  284. data/vendor/local/share/gtk-doc/html/gio/GEmblemedIcon.html +0 -206
  285. data/vendor/local/share/gtk-doc/html/gio/GFile.html +0 -7462
  286. data/vendor/local/share/gtk-doc/html/gio/GFileDescriptorBased.html +0 -120
  287. data/vendor/local/share/gtk-doc/html/gio/GFileEnumerator.html +0 -516
  288. data/vendor/local/share/gtk-doc/html/gio/GFileIOStream.html +0 -312
  289. data/vendor/local/share/gtk-doc/html/gio/GFileIcon.html +0 -155
  290. data/vendor/local/share/gtk-doc/html/gio/GFileInfo.html +0 -3144
  291. data/vendor/local/share/gtk-doc/html/gio/GFileInputStream.html +0 -262
  292. data/vendor/local/share/gtk-doc/html/gio/GFileMonitor.html +0 -353
  293. data/vendor/local/share/gtk-doc/html/gio/GFileOutputStream.html +0 -301
  294. data/vendor/local/share/gtk-doc/html/gio/GFilenameCompleter.html +0 -217
  295. data/vendor/local/share/gtk-doc/html/gio/GFilterInputStream.html +0 -188
  296. data/vendor/local/share/gtk-doc/html/gio/GFilterOutputStream.html +0 -189
  297. data/vendor/local/share/gtk-doc/html/gio/GIOModule.html +0 -261
  298. data/vendor/local/share/gtk-doc/html/gio/GIOStream.html +0 -479
  299. data/vendor/local/share/gtk-doc/html/gio/GIcon.html +0 -331
  300. data/vendor/local/share/gtk-doc/html/gio/GInetAddress.html +0 -717
  301. data/vendor/local/share/gtk-doc/html/gio/GInetSocketAddress.html +0 -196
  302. data/vendor/local/share/gtk-doc/html/gio/GInitable.html +0 -388
  303. data/vendor/local/share/gtk-doc/html/gio/GInputStream.html +0 -808
  304. data/vendor/local/share/gtk-doc/html/gio/GLoadableIcon.html +0 -301
  305. data/vendor/local/share/gtk-doc/html/gio/GMemoryInputStream.html +0 -185
  306. data/vendor/local/share/gtk-doc/html/gio/GMemoryOutputStream.html +0 -393
  307. data/vendor/local/share/gtk-doc/html/gio/GMount.html +0 -1465
  308. data/vendor/local/share/gtk-doc/html/gio/GMountOperation.html +0 -848
  309. data/vendor/local/share/gtk-doc/html/gio/GNetworkAddress.html +0 -343
  310. data/vendor/local/share/gtk-doc/html/gio/GNetworkService.html +0 -311
  311. data/vendor/local/share/gtk-doc/html/gio/GOutputStream.html +0 -1012
  312. data/vendor/local/share/gtk-doc/html/gio/GPermission.html +0 -560
  313. data/vendor/local/share/gtk-doc/html/gio/GProxy.html +0 -312
  314. data/vendor/local/share/gtk-doc/html/gio/GProxyAddress.html +0 -348
  315. data/vendor/local/share/gtk-doc/html/gio/GProxyResolver.html +0 -301
  316. data/vendor/local/share/gtk-doc/html/gio/GResolver.html +0 -787
  317. data/vendor/local/share/gtk-doc/html/gio/GSeekable.html +0 -350
  318. data/vendor/local/share/gtk-doc/html/gio/GSettings.html +0 -2424
  319. data/vendor/local/share/gtk-doc/html/gio/GSettingsBackend.html +0 -609
  320. data/vendor/local/share/gtk-doc/html/gio/GSimpleAsyncResult.html +0 -1193
  321. data/vendor/local/share/gtk-doc/html/gio/GSimplePermission.html +0 -107
  322. data/vendor/local/share/gtk-doc/html/gio/GSocket.html +0 -2438
  323. data/vendor/local/share/gtk-doc/html/gio/GSocketAddress.html +0 -297
  324. data/vendor/local/share/gtk-doc/html/gio/GSocketClient.html +0 -1292
  325. data/vendor/local/share/gtk-doc/html/gio/GSocketConnectable.html +0 -513
  326. data/vendor/local/share/gtk-doc/html/gio/GSocketConnection.html +0 -337
  327. data/vendor/local/share/gtk-doc/html/gio/GSocketControlMessage.html +0 -275
  328. data/vendor/local/share/gtk-doc/html/gio/GSocketListener.html +0 -745
  329. data/vendor/local/share/gtk-doc/html/gio/GSocketService.html +0 -258
  330. data/vendor/local/share/gtk-doc/html/gio/GTcpConnection.html +0 -165
  331. data/vendor/local/share/gtk-doc/html/gio/GThemedIcon.html +0 -377
  332. data/vendor/local/share/gtk-doc/html/gio/GThreadedSocketService.html +0 -197
  333. data/vendor/local/share/gtk-doc/html/gio/GUnixConnection.html +0 -298
  334. data/vendor/local/share/gtk-doc/html/gio/GUnixCredentialsMessage.html +0 -222
  335. data/vendor/local/share/gtk-doc/html/gio/GUnixFDList.html +0 -389
  336. data/vendor/local/share/gtk-doc/html/gio/GUnixFDMessage.html +0 -288
  337. data/vendor/local/share/gtk-doc/html/gio/GUnixInputStream.html +0 -237
  338. data/vendor/local/share/gtk-doc/html/gio/GUnixOutputStream.html +0 -237
  339. data/vendor/local/share/gtk-doc/html/gio/GUnixSocketAddress.html +0 -491
  340. data/vendor/local/share/gtk-doc/html/gio/GVfs.html +0 -274
  341. data/vendor/local/share/gtk-doc/html/gio/GVolume.html +0 -1028
  342. data/vendor/local/share/gtk-doc/html/gio/GVolumeMonitor.html +0 -705
  343. data/vendor/local/share/gtk-doc/html/gio/GZlibCompressor.html +0 -252
  344. data/vendor/local/share/gtk-doc/html/gio/GZlibDecompressor.html +0 -170
  345. data/vendor/local/share/gtk-doc/html/gio/annotation-glossary.html +0 -65
  346. data/vendor/local/share/gtk-doc/html/gio/api-index-2-18.html +0 -153
  347. data/vendor/local/share/gtk-doc/html/gio/api-index-2-20.html +0 -155
  348. data/vendor/local/share/gtk-doc/html/gio/api-index-2-22.html +0 -1084
  349. data/vendor/local/share/gtk-doc/html/gio/api-index-2-24.html +0 -223
  350. data/vendor/local/share/gtk-doc/html/gio/api-index-2-26.html +0 -1598
  351. data/vendor/local/share/gtk-doc/html/gio/api-index-deprecated.html +0 -112
  352. data/vendor/local/share/gtk-doc/html/gio/api-index-full.html +0 -6250
  353. data/vendor/local/share/gtk-doc/html/gio/async.html +0 -44
  354. data/vendor/local/share/gtk-doc/html/gio/ch01.html +0 -207
  355. data/vendor/local/share/gtk-doc/html/gio/ch02.html +0 -50
  356. data/vendor/local/share/gtk-doc/html/gio/ch03.html +0 -180
  357. data/vendor/local/share/gtk-doc/html/gio/ch24.html +0 -75
  358. data/vendor/local/share/gtk-doc/html/gio/ch25.html +0 -217
  359. data/vendor/local/share/gtk-doc/html/gio/ch25s02.html +0 -41
  360. data/vendor/local/share/gtk-doc/html/gio/ch25s03.html +0 -39
  361. data/vendor/local/share/gtk-doc/html/gio/ch26.html +0 -57
  362. data/vendor/local/share/gtk-doc/html/gio/ch26s02.html +0 -59
  363. data/vendor/local/share/gtk-doc/html/gio/ch26s03.html +0 -159
  364. data/vendor/local/share/gtk-doc/html/gio/ch26s04.html +0 -46
  365. data/vendor/local/share/gtk-doc/html/gio/ch26s05.html +0 -48
  366. data/vendor/local/share/gtk-doc/html/gio/ch26s06.html +0 -277
  367. data/vendor/local/share/gtk-doc/html/gio/ch26s07.html +0 -95
  368. data/vendor/local/share/gtk-doc/html/gio/ch27.html +0 -70
  369. data/vendor/local/share/gtk-doc/html/gio/ch27s02.html +0 -130
  370. data/vendor/local/share/gtk-doc/html/gio/ch27s03.html +0 -202
  371. data/vendor/local/share/gtk-doc/html/gio/ch27s04.html +0 -96
  372. data/vendor/local/share/gtk-doc/html/gio/ch27s05.html +0 -823
  373. data/vendor/local/share/gtk-doc/html/gio/ch27s06.html +0 -828
  374. data/vendor/local/share/gtk-doc/html/gio/conversion.html +0 -44
  375. data/vendor/local/share/gtk-doc/html/gio/extending-gio.html +0 -109
  376. data/vendor/local/share/gtk-doc/html/gio/extending.html +0 -41
  377. data/vendor/local/share/gtk-doc/html/gio/failable_initialization.html +0 -38
  378. data/vendor/local/share/gtk-doc/html/gio/file_mon.html +0 -33
  379. data/vendor/local/share/gtk-doc/html/gio/file_ops.html +0 -50
  380. data/vendor/local/share/gtk-doc/html/gio/gdbus-convenience.html +0 -41
  381. data/vendor/local/share/gtk-doc/html/gio/gdbus-lowlevel.html +0 -59
  382. data/vendor/local/share/gtk-doc/html/gio/gdbus.html +0 -243
  383. data/vendor/local/share/gtk-doc/html/gio/gio-D-Bus-Addresses.html +0 -316
  384. data/vendor/local/share/gtk-doc/html/gio/gio-D-Bus-Introspection-Data.html +0 -1117
  385. data/vendor/local/share/gtk-doc/html/gio/gio-D-Bus-Utilities.html +0 -216
  386. data/vendor/local/share/gtk-doc/html/gio/gio-Desktop-file-based-GAppInfo.html +0 -339
  387. data/vendor/local/share/gtk-doc/html/gio/gio-Extension-Points.html +0 -473
  388. data/vendor/local/share/gtk-doc/html/gio/gio-GContentType.html +0 -391
  389. data/vendor/local/share/gtk-doc/html/gio/gio-GConverterInputstream.html +0 -159
  390. data/vendor/local/share/gtk-doc/html/gio/gio-GConverterOutputstream.html +0 -159
  391. data/vendor/local/share/gtk-doc/html/gio/gio-GDBusError.html +0 -908
  392. data/vendor/local/share/gtk-doc/html/gio/gio-GFileAttribute.html +0 -933
  393. data/vendor/local/share/gtk-doc/html/gio/gio-GIOError.html +0 -409
  394. data/vendor/local/share/gtk-doc/html/gio/gio-GIOScheduler.html +0 -297
  395. data/vendor/local/share/gtk-doc/html/gio/gio-GSrvTarget.html +0 -313
  396. data/vendor/local/share/gtk-doc/html/gio/gio-Owning-Bus-Names.html +0 -736
  397. data/vendor/local/share/gtk-doc/html/gio/gio-Unix-Mounts.html +0 -909
  398. data/vendor/local/share/gtk-doc/html/gio/gio-Watching-Bus-Names.html +0 -666
  399. data/vendor/local/share/gtk-doc/html/gio/gio-hierarchy.html +0 -123
  400. data/vendor/local/share/gtk-doc/html/gio/gio-querymodules.html +0 -53
  401. data/vendor/local/share/gtk-doc/html/gio/gio.devhelp +0 -1736
  402. data/vendor/local/share/gtk-doc/html/gio/gio.devhelp2 +0 -2006
  403. data/vendor/local/share/gtk-doc/html/gio/glib-compile-schemas.html +0 -102
  404. data/vendor/local/share/gtk-doc/html/gio/gvfs-overview.png +0 -0
  405. data/vendor/local/share/gtk-doc/html/gio/highlevel-socket.html +0 -53
  406. data/vendor/local/share/gtk-doc/html/gio/home.png +0 -0
  407. data/vendor/local/share/gtk-doc/html/gio/icons.html +0 -50
  408. data/vendor/local/share/gtk-doc/html/gio/index.html +0 -435
  409. data/vendor/local/share/gtk-doc/html/gio/index.sgml +0 -2513
  410. data/vendor/local/share/gtk-doc/html/gio/left.png +0 -0
  411. data/vendor/local/share/gtk-doc/html/gio/migrating.html +0 -62
  412. data/vendor/local/share/gtk-doc/html/gio/networking.html +0 -69
  413. data/vendor/local/share/gtk-doc/html/gio/permissions.html +0 -39
  414. data/vendor/local/share/gtk-doc/html/gio/pt01.html +0 -39
  415. data/vendor/local/share/gtk-doc/html/gio/pt02.html +0 -390
  416. data/vendor/local/share/gtk-doc/html/gio/resolver.html +0 -50
  417. data/vendor/local/share/gtk-doc/html/gio/right.png +0 -0
  418. data/vendor/local/share/gtk-doc/html/gio/settings.html +0 -38
  419. data/vendor/local/share/gtk-doc/html/gio/streaming.html +0 -92
  420. data/vendor/local/share/gtk-doc/html/gio/style.css +0 -265
  421. data/vendor/local/share/gtk-doc/html/gio/tools.html +0 -44
  422. data/vendor/local/share/gtk-doc/html/gio/types.html +0 -41
  423. data/vendor/local/share/gtk-doc/html/gio/up.png +0 -0
  424. data/vendor/local/share/gtk-doc/html/gio/utils.html +0 -33
  425. data/vendor/local/share/gtk-doc/html/gio/volume_mon.html +0 -47
  426. data/vendor/local/share/gtk-doc/html/glib/annotation-glossary.html +0 -77
  427. data/vendor/local/share/gtk-doc/html/glib/api-index-2-10.html +0 -180
  428. data/vendor/local/share/gtk-doc/html/glib/api-index-2-12.html +0 -312
  429. data/vendor/local/share/gtk-doc/html/glib/api-index-2-14.html +0 -559
  430. data/vendor/local/share/gtk-doc/html/glib/api-index-2-16.html +0 -362
  431. data/vendor/local/share/gtk-doc/html/glib/api-index-2-18.html +0 -102
  432. data/vendor/local/share/gtk-doc/html/glib/api-index-2-2.html +0 -124
  433. data/vendor/local/share/gtk-doc/html/glib/api-index-2-20.html +0 -83
  434. data/vendor/local/share/gtk-doc/html/glib/api-index-2-22.html +0 -194
  435. data/vendor/local/share/gtk-doc/html/glib/api-index-2-24.html +0 -420
  436. data/vendor/local/share/gtk-doc/html/glib/api-index-2-26.html +0 -359
  437. data/vendor/local/share/gtk-doc/html/glib/api-index-2-4.html +0 -396
  438. data/vendor/local/share/gtk-doc/html/glib/api-index-2-6.html +0 -417
  439. data/vendor/local/share/gtk-doc/html/glib/api-index-2-8.html +0 -158
  440. data/vendor/local/share/gtk-doc/html/glib/api-index-deprecated.html +0 -419
  441. data/vendor/local/share/gtk-doc/html/glib/api-index-full.html +0 -8214
  442. data/vendor/local/share/gtk-doc/html/glib/file-name-encodings.png +0 -0
  443. data/vendor/local/share/gtk-doc/html/glib/glib-Arrays.html +0 -893
  444. data/vendor/local/share/gtk-doc/html/glib/glib-Asynchronous-Queues.html +0 -818
  445. data/vendor/local/share/gtk-doc/html/glib/glib-Atomic-Operations.html +0 -414
  446. data/vendor/local/share/gtk-doc/html/glib/glib-Automatic-String-Completion.html +0 -466
  447. data/vendor/local/share/gtk-doc/html/glib/glib-Balanced-Binary-Trees.html +0 -802
  448. data/vendor/local/share/gtk-doc/html/glib/glib-Base64-Encoding.html +0 -372
  449. data/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html +0 -500
  450. data/vendor/local/share/gtk-doc/html/glib/glib-Bookmark-file-parser.html +0 -2056
  451. data/vendor/local/share/gtk-doc/html/glib/glib-Byte-Arrays.html +0 -560
  452. data/vendor/local/share/gtk-doc/html/glib/glib-Byte-Order-Macros.html +0 -1686
  453. data/vendor/local/share/gtk-doc/html/glib/glib-Caches.html +0 -398
  454. data/vendor/local/share/gtk-doc/html/glib/glib-Character-Set-Conversion.html +0 -1094
  455. data/vendor/local/share/gtk-doc/html/glib/glib-Commandline-option-parser.html +0 -1671
  456. data/vendor/local/share/gtk-doc/html/glib/glib-Data-Checksums.html +0 -460
  457. data/vendor/local/share/gtk-doc/html/glib/glib-Datasets.html +0 -528
  458. data/vendor/local/share/gtk-doc/html/glib/glib-Date-and-Time-Functions.html +0 -2045
  459. data/vendor/local/share/gtk-doc/html/glib/glib-Double-ended-Queues.html +0 -1278
  460. data/vendor/local/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html +0 -1406
  461. data/vendor/local/share/gtk-doc/html/glib/glib-Dynamic-Loading-of-Modules.html +0 -548
  462. data/vendor/local/share/gtk-doc/html/glib/glib-Error-Reporting.html +0 -1026
  463. data/vendor/local/share/gtk-doc/html/glib/glib-File-Utilities.html +0 -1852
  464. data/vendor/local/share/gtk-doc/html/glib/glib-GDateTime.html +0 -2201
  465. data/vendor/local/share/gtk-doc/html/glib/glib-GTimeZone.html +0 -239
  466. data/vendor/local/share/gtk-doc/html/glib/glib-GVariant.html +0 -4278
  467. data/vendor/local/share/gtk-doc/html/glib/glib-GVariantType.html +0 -1864
  468. data/vendor/local/share/gtk-doc/html/glib/glib-Glob-style-pattern-matching.html +0 -295
  469. data/vendor/local/share/gtk-doc/html/glib/glib-Hash-Tables.html +0 -1512
  470. data/vendor/local/share/gtk-doc/html/glib/glib-Hook-Functions.html +0 -1367
  471. data/vendor/local/share/gtk-doc/html/glib/glib-Hostname-Utilities.html +0 -229
  472. data/vendor/local/share/gtk-doc/html/glib/glib-I18N.html +0 -692
  473. data/vendor/local/share/gtk-doc/html/glib/glib-IO-Channels.html +0 -2196
  474. data/vendor/local/share/gtk-doc/html/glib/glib-Key-value-file-parser.html +0 -2740
  475. data/vendor/local/share/gtk-doc/html/glib/glib-Keyed-Data-Lists.html +0 -612
  476. data/vendor/local/share/gtk-doc/html/glib/glib-Lexical-Scanner.html +0 -1451
  477. data/vendor/local/share/gtk-doc/html/glib/glib-Limits-of-Basic-Types.html +0 -389
  478. data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocation.html +0 -1033
  479. data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocators.html +0 -141
  480. data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Chunks.html +0 -706
  481. data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Slices.html +0 -510
  482. data/vendor/local/share/gtk-doc/html/glib/glib-Message-Logging.html +0 -748
  483. data/vendor/local/share/gtk-doc/html/glib/glib-Miscellaneous-Macros.html +0 -1105
  484. data/vendor/local/share/gtk-doc/html/glib/glib-Miscellaneous-Utility-Functions.html +0 -1552
  485. data/vendor/local/share/gtk-doc/html/glib/glib-N-ary-Trees.html +0 -1468
  486. data/vendor/local/share/gtk-doc/html/glib/glib-Numerical-Definitions.html +0 -194
  487. data/vendor/local/share/gtk-doc/html/glib/glib-Perl-compatible-regular-expressions.html +0 -2745
  488. data/vendor/local/share/gtk-doc/html/glib/glib-Pointer-Arrays.html +0 -752
  489. data/vendor/local/share/gtk-doc/html/glib/glib-Quarks.html +0 -269
  490. data/vendor/local/share/gtk-doc/html/glib/glib-Random-Numbers.html +0 -578
  491. data/vendor/local/share/gtk-doc/html/glib/glib-Relations-and-Tuples.html +0 -532
  492. data/vendor/local/share/gtk-doc/html/glib/glib-Sequences.html +0 -1353
  493. data/vendor/local/share/gtk-doc/html/glib/glib-Shell-related-Utilities.html +0 -238
  494. data/vendor/local/share/gtk-doc/html/glib/glib-Simple-XML-Subset-Parser.html +0 -1282
  495. data/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html +0 -1213
  496. data/vendor/local/share/gtk-doc/html/glib/glib-Spawning-Processes.html +0 -924
  497. data/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html +0 -470
  498. data/vendor/local/share/gtk-doc/html/glib/glib-String-Chunks.html +0 -301
  499. data/vendor/local/share/gtk-doc/html/glib/glib-String-Utility-Functions.html +0 -2960
  500. data/vendor/local/share/gtk-doc/html/glib/glib-Strings.html +0 -1291
  501. data/vendor/local/share/gtk-doc/html/glib/glib-Testing.html +0 -1805
  502. data/vendor/local/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html +0 -3478
  503. data/vendor/local/share/gtk-doc/html/glib/glib-Thread-Pools.html +0 -606
  504. data/vendor/local/share/gtk-doc/html/glib/glib-Threads.html +0 -3411
  505. data/vendor/local/share/gtk-doc/html/glib/glib-Timers.html +0 -245
  506. data/vendor/local/share/gtk-doc/html/glib/glib-Trash-Stacks.html +0 -188
  507. data/vendor/local/share/gtk-doc/html/glib/glib-Type-Conversion-Macros.html +0 -263
  508. data/vendor/local/share/gtk-doc/html/glib/glib-URI-Functions.html +0 -400
  509. data/vendor/local/share/gtk-doc/html/glib/glib-Unicode-Manipulation.html +0 -3448
  510. data/vendor/local/share/gtk-doc/html/glib/glib-Version-Information.html +0 -253
  511. data/vendor/local/share/gtk-doc/html/glib/glib-Warnings-and-Assertions.html +0 -438
  512. data/vendor/local/share/gtk-doc/html/glib/glib-Windows-Compatibility-Functions.html +0 -476
  513. data/vendor/local/share/gtk-doc/html/glib/glib-building.html +0 -466
  514. data/vendor/local/share/gtk-doc/html/glib/glib-changes.html +0 -159
  515. data/vendor/local/share/gtk-doc/html/glib/glib-compiling.html +0 -118
  516. data/vendor/local/share/gtk-doc/html/glib/glib-core.html +0 -64
  517. data/vendor/local/share/gtk-doc/html/glib/glib-cross-compiling.html +0 -160
  518. data/vendor/local/share/gtk-doc/html/glib/glib-data-types.html +0 -120
  519. data/vendor/local/share/gtk-doc/html/glib/glib-fundamentals.html +0 -59
  520. data/vendor/local/share/gtk-doc/html/glib/glib-gettextize.html +0 -93
  521. data/vendor/local/share/gtk-doc/html/glib/glib-regex-syntax.html +0 -2217
  522. data/vendor/local/share/gtk-doc/html/glib/glib-resources.html +0 -121
  523. data/vendor/local/share/gtk-doc/html/glib/glib-running.html +0 -319
  524. data/vendor/local/share/gtk-doc/html/glib/glib-utilities.html +0 -118
  525. data/vendor/local/share/gtk-doc/html/glib/glib.devhelp +0 -2183
  526. data/vendor/local/share/gtk-doc/html/glib/glib.devhelp2 +0 -2671
  527. data/vendor/local/share/gtk-doc/html/glib/glib.html +0 -80
  528. data/vendor/local/share/gtk-doc/html/glib/gtester-report.html +0 -72
  529. data/vendor/local/share/gtk-doc/html/glib/gtester.html +0 -131
  530. data/vendor/local/share/gtk-doc/html/glib/gvariant-format-strings.html +0 -1288
  531. data/vendor/local/share/gtk-doc/html/glib/home.png +0 -0
  532. data/vendor/local/share/gtk-doc/html/glib/index.html +0 -344
  533. data/vendor/local/share/gtk-doc/html/glib/index.sgml +0 -2846
  534. data/vendor/local/share/gtk-doc/html/glib/left.png +0 -0
  535. data/vendor/local/share/gtk-doc/html/glib/mainloop-states.gif +0 -0
  536. data/vendor/local/share/gtk-doc/html/glib/right.png +0 -0
  537. data/vendor/local/share/gtk-doc/html/glib/style.css +0 -265
  538. data/vendor/local/share/gtk-doc/html/glib/tools.html +0 -41
  539. data/vendor/local/share/gtk-doc/html/glib/up.png +0 -0
  540. data/vendor/local/share/gtk-doc/html/gobject/GBinding.html +0 -803
  541. data/vendor/local/share/gtk-doc/html/gobject/GTypeModule.html +0 -710
  542. data/vendor/local/share/gtk-doc/html/gobject/GTypePlugin.html +0 -453
  543. data/vendor/local/share/gtk-doc/html/gobject/annotation-glossary.html +0 -47
  544. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-10.html +0 -85
  545. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-12.html +0 -55
  546. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-14.html +0 -51
  547. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-18.html +0 -46
  548. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-2.html +0 -38
  549. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-22.html +0 -46
  550. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-24.html +0 -73
  551. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-26.html +0 -201
  552. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-4.html +0 -178
  553. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-6.html +0 -42
  554. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-8.html +0 -42
  555. data/vendor/local/share/gtk-doc/html/gobject/api-index-deprecated.html +0 -50
  556. data/vendor/local/share/gtk-doc/html/gobject/api-index-full.html +0 -2721
  557. data/vendor/local/share/gtk-doc/html/gobject/ch01s02.html +0 -136
  558. data/vendor/local/share/gtk-doc/html/gobject/ch06s03.html +0 -113
  559. data/vendor/local/share/gtk-doc/html/gobject/chapter-gobject.html +0 -293
  560. data/vendor/local/share/gtk-doc/html/gobject/chapter-gtype.html +0 -263
  561. data/vendor/local/share/gtk-doc/html/gobject/chapter-intro.html +0 -92
  562. data/vendor/local/share/gtk-doc/html/gobject/chapter-signal.html +0 -214
  563. data/vendor/local/share/gtk-doc/html/gobject/glib-genmarshal.html +0 -361
  564. data/vendor/local/share/gtk-doc/html/gobject/glib-mkenums.html +0 -307
  565. data/vendor/local/share/gtk-doc/html/gobject/glue.png +0 -0
  566. data/vendor/local/share/gtk-doc/html/gobject/gobject-Boxed-Types.html +0 -417
  567. data/vendor/local/share/gtk-doc/html/gobject/gobject-Closures.html +0 -2412
  568. data/vendor/local/share/gtk-doc/html/gobject/gobject-Enumeration-and-Flag-Types.html +0 -847
  569. data/vendor/local/share/gtk-doc/html/gobject/gobject-GParamSpec.html +0 -1433
  570. data/vendor/local/share/gtk-doc/html/gobject/gobject-Generic-values.html +0 -776
  571. data/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html +0 -2741
  572. data/vendor/local/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html +0 -5555
  573. data/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html +0 -2875
  574. data/vendor/local/share/gtk-doc/html/gobject/gobject-Type-Information.html +0 -4460
  575. data/vendor/local/share/gtk-doc/html/gobject/gobject-Value-arrays.html +0 -416
  576. data/vendor/local/share/gtk-doc/html/gobject/gobject-Varargs-Value-Collection.html +0 -260
  577. data/vendor/local/share/gtk-doc/html/gobject/gobject-memory.html +0 -234
  578. data/vendor/local/share/gtk-doc/html/gobject/gobject-properties.html +0 -270
  579. data/vendor/local/share/gtk-doc/html/gobject/gobject-query.html +0 -117
  580. data/vendor/local/share/gtk-doc/html/gobject/gobject.devhelp +0 -762
  581. data/vendor/local/share/gtk-doc/html/gobject/gobject.devhelp2 +0 -801
  582. data/vendor/local/share/gtk-doc/html/gobject/gtype-conventions.html +0 -143
  583. data/vendor/local/share/gtk-doc/html/gobject/gtype-instantiable-classed.html +0 -287
  584. data/vendor/local/share/gtk-doc/html/gobject/gtype-non-instantiable-classed.html +0 -316
  585. data/vendor/local/share/gtk-doc/html/gobject/gtype-non-instantiable.html +0 -76
  586. data/vendor/local/share/gtk-doc/html/gobject/home.png +0 -0
  587. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-chainup.html +0 -100
  588. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-code.html +0 -86
  589. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-construction.html +0 -113
  590. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-destruction.html +0 -122
  591. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-methods.html +0 -257
  592. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject.html +0 -283
  593. data/vendor/local/share/gtk-doc/html/gobject/howto-interface-implement.html +0 -125
  594. data/vendor/local/share/gtk-doc/html/gobject/howto-interface-properties.html +0 -167
  595. data/vendor/local/share/gtk-doc/html/gobject/howto-interface.html +0 -160
  596. data/vendor/local/share/gtk-doc/html/gobject/howto-signals.html +0 -121
  597. data/vendor/local/share/gtk-doc/html/gobject/index.html +0 -192
  598. data/vendor/local/share/gtk-doc/html/gobject/index.sgml +0 -786
  599. data/vendor/local/share/gtk-doc/html/gobject/left.png +0 -0
  600. data/vendor/local/share/gtk-doc/html/gobject/pr01.html +0 -72
  601. data/vendor/local/share/gtk-doc/html/gobject/pt01.html +0 -80
  602. data/vendor/local/share/gtk-doc/html/gobject/pt02.html +0 -66
  603. data/vendor/local/share/gtk-doc/html/gobject/pt03.html +0 -55
  604. data/vendor/local/share/gtk-doc/html/gobject/right.png +0 -0
  605. data/vendor/local/share/gtk-doc/html/gobject/rn01.html +0 -85
  606. data/vendor/local/share/gtk-doc/html/gobject/rn02.html +0 -47
  607. data/vendor/local/share/gtk-doc/html/gobject/signal.html +0 -377
  608. data/vendor/local/share/gtk-doc/html/gobject/style.css +0 -265
  609. data/vendor/local/share/gtk-doc/html/gobject/tools-ginspector.html +0 -35
  610. data/vendor/local/share/gtk-doc/html/gobject/tools-gob.html +0 -40
  611. data/vendor/local/share/gtk-doc/html/gobject/tools-gtkdoc.html +0 -63
  612. data/vendor/local/share/gtk-doc/html/gobject/tools-refdb.html +0 -55
  613. data/vendor/local/share/gtk-doc/html/gobject/tools-vala.html +0 -43
  614. data/vendor/local/share/gtk-doc/html/gobject/up.png +0 -0
  615. data/vendor/local/share/locale/af/LC_MESSAGES/glib20.mo +0 -0
  616. data/vendor/local/share/locale/am/LC_MESSAGES/glib20.mo +0 -0
  617. data/vendor/local/share/locale/ar/LC_MESSAGES/glib20.mo +0 -0
  618. data/vendor/local/share/locale/as/LC_MESSAGES/glib20.mo +0 -0
  619. data/vendor/local/share/locale/ast/LC_MESSAGES/glib20.mo +0 -0
  620. data/vendor/local/share/locale/az/LC_MESSAGES/glib20.mo +0 -0
  621. data/vendor/local/share/locale/be/LC_MESSAGES/gettext-runtime.mo +0 -0
  622. data/vendor/local/share/locale/be/LC_MESSAGES/glib20.mo +0 -0
  623. data/vendor/local/share/locale/be@latin/LC_MESSAGES/glib20.mo +0 -0
  624. data/vendor/local/share/locale/bg/LC_MESSAGES/gettext-runtime.mo +0 -0
  625. data/vendor/local/share/locale/bg/LC_MESSAGES/glib20.mo +0 -0
  626. data/vendor/local/share/locale/bn/LC_MESSAGES/glib20.mo +0 -0
  627. data/vendor/local/share/locale/bn_IN/LC_MESSAGES/glib20.mo +0 -0
  628. data/vendor/local/share/locale/bs/LC_MESSAGES/glib20.mo +0 -0
  629. data/vendor/local/share/locale/ca/LC_MESSAGES/gettext-runtime.mo +0 -0
  630. data/vendor/local/share/locale/ca/LC_MESSAGES/glib20.mo +0 -0
  631. data/vendor/local/share/locale/ca@valencia/LC_MESSAGES/glib20.mo +0 -0
  632. data/vendor/local/share/locale/cs/LC_MESSAGES/gettext-runtime.mo +0 -0
  633. data/vendor/local/share/locale/cs/LC_MESSAGES/glib20.mo +0 -0
  634. data/vendor/local/share/locale/cy/LC_MESSAGES/glib20.mo +0 -0
  635. data/vendor/local/share/locale/da/LC_MESSAGES/gettext-runtime.mo +0 -0
  636. data/vendor/local/share/locale/da/LC_MESSAGES/glib20.mo +0 -0
  637. data/vendor/local/share/locale/de/LC_MESSAGES/gettext-runtime.mo +0 -0
  638. data/vendor/local/share/locale/de/LC_MESSAGES/glib20.mo +0 -0
  639. data/vendor/local/share/locale/dz/LC_MESSAGES/glib20.mo +0 -0
  640. data/vendor/local/share/locale/el/LC_MESSAGES/gettext-runtime.mo +0 -0
  641. data/vendor/local/share/locale/el/LC_MESSAGES/glib20.mo +0 -0
  642. data/vendor/local/share/locale/en@boldquot/LC_MESSAGES/gettext-runtime.mo +0 -0
  643. data/vendor/local/share/locale/en@quot/LC_MESSAGES/gettext-runtime.mo +0 -0
  644. data/vendor/local/share/locale/en@shaw/LC_MESSAGES/glib20.mo +0 -0
  645. data/vendor/local/share/locale/en_CA/LC_MESSAGES/glib20.mo +0 -0
  646. data/vendor/local/share/locale/en_GB/LC_MESSAGES/glib20.mo +0 -0
  647. data/vendor/local/share/locale/eo/LC_MESSAGES/gettext-runtime.mo +0 -0
  648. data/vendor/local/share/locale/eo/LC_MESSAGES/glib20.mo +0 -0
  649. data/vendor/local/share/locale/es/LC_MESSAGES/gettext-runtime.mo +0 -0
  650. data/vendor/local/share/locale/es/LC_MESSAGES/glib20.mo +0 -0
  651. data/vendor/local/share/locale/et/LC_MESSAGES/gettext-runtime.mo +0 -0
  652. data/vendor/local/share/locale/et/LC_MESSAGES/glib20.mo +0 -0
  653. data/vendor/local/share/locale/eu/LC_MESSAGES/glib20.mo +0 -0
  654. data/vendor/local/share/locale/fa/LC_MESSAGES/glib20.mo +0 -0
  655. data/vendor/local/share/locale/fi/LC_MESSAGES/gettext-runtime.mo +0 -0
  656. data/vendor/local/share/locale/fi/LC_MESSAGES/glib20.mo +0 -0
  657. data/vendor/local/share/locale/fr/LC_MESSAGES/gettext-runtime.mo +0 -0
  658. data/vendor/local/share/locale/fr/LC_MESSAGES/glib20.mo +0 -0
  659. data/vendor/local/share/locale/ga/LC_MESSAGES/gettext-runtime.mo +0 -0
  660. data/vendor/local/share/locale/ga/LC_MESSAGES/glib20.mo +0 -0
  661. data/vendor/local/share/locale/gl/LC_MESSAGES/gettext-runtime.mo +0 -0
  662. data/vendor/local/share/locale/gl/LC_MESSAGES/glib20.mo +0 -0
  663. data/vendor/local/share/locale/gu/LC_MESSAGES/glib20.mo +0 -0
  664. data/vendor/local/share/locale/he/LC_MESSAGES/glib20.mo +0 -0
  665. data/vendor/local/share/locale/hi/LC_MESSAGES/glib20.mo +0 -0
  666. data/vendor/local/share/locale/hr/LC_MESSAGES/glib20.mo +0 -0
  667. data/vendor/local/share/locale/hu/LC_MESSAGES/glib20.mo +0 -0
  668. data/vendor/local/share/locale/hy/LC_MESSAGES/glib20.mo +0 -0
  669. data/vendor/local/share/locale/id/LC_MESSAGES/gettext-runtime.mo +0 -0
  670. data/vendor/local/share/locale/id/LC_MESSAGES/glib20.mo +0 -0
  671. data/vendor/local/share/locale/is/LC_MESSAGES/glib20.mo +0 -0
  672. data/vendor/local/share/locale/it/LC_MESSAGES/gettext-runtime.mo +0 -0
  673. data/vendor/local/share/locale/it/LC_MESSAGES/glib20.mo +0 -0
  674. data/vendor/local/share/locale/ja/LC_MESSAGES/gettext-runtime.mo +0 -0
  675. data/vendor/local/share/locale/ja/LC_MESSAGES/glib20.mo +0 -0
  676. data/vendor/local/share/locale/ka/LC_MESSAGES/glib20.mo +0 -0
  677. data/vendor/local/share/locale/kk/LC_MESSAGES/glib20.mo +0 -0
  678. data/vendor/local/share/locale/kn/LC_MESSAGES/glib20.mo +0 -0
  679. data/vendor/local/share/locale/ko/LC_MESSAGES/gettext-runtime.mo +0 -0
  680. data/vendor/local/share/locale/ko/LC_MESSAGES/glib20.mo +0 -0
  681. data/vendor/local/share/locale/ku/LC_MESSAGES/glib20.mo +0 -0
  682. data/vendor/local/share/locale/locale.alias +0 -77
  683. data/vendor/local/share/locale/lt/LC_MESSAGES/glib20.mo +0 -0
  684. data/vendor/local/share/locale/lv/LC_MESSAGES/glib20.mo +0 -0
  685. data/vendor/local/share/locale/mai/LC_MESSAGES/glib20.mo +0 -0
  686. data/vendor/local/share/locale/mg/LC_MESSAGES/glib20.mo +0 -0
  687. data/vendor/local/share/locale/mk/LC_MESSAGES/glib20.mo +0 -0
  688. data/vendor/local/share/locale/ml/LC_MESSAGES/glib20.mo +0 -0
  689. data/vendor/local/share/locale/mn/LC_MESSAGES/glib20.mo +0 -0
  690. data/vendor/local/share/locale/mr/LC_MESSAGES/glib20.mo +0 -0
  691. data/vendor/local/share/locale/ms/LC_MESSAGES/glib20.mo +0 -0
  692. data/vendor/local/share/locale/nb/LC_MESSAGES/gettext-runtime.mo +0 -0
  693. data/vendor/local/share/locale/nb/LC_MESSAGES/glib20.mo +0 -0
  694. data/vendor/local/share/locale/nds/LC_MESSAGES/glib20.mo +0 -0
  695. data/vendor/local/share/locale/ne/LC_MESSAGES/glib20.mo +0 -0
  696. data/vendor/local/share/locale/nl/LC_MESSAGES/gettext-runtime.mo +0 -0
  697. data/vendor/local/share/locale/nl/LC_MESSAGES/glib20.mo +0 -0
  698. data/vendor/local/share/locale/nn/LC_MESSAGES/gettext-runtime.mo +0 -0
  699. data/vendor/local/share/locale/nn/LC_MESSAGES/glib20.mo +0 -0
  700. data/vendor/local/share/locale/oc/LC_MESSAGES/glib20.mo +0 -0
  701. data/vendor/local/share/locale/or/LC_MESSAGES/glib20.mo +0 -0
  702. data/vendor/local/share/locale/pa/LC_MESSAGES/glib20.mo +0 -0
  703. data/vendor/local/share/locale/pl/LC_MESSAGES/gettext-runtime.mo +0 -0
  704. data/vendor/local/share/locale/pl/LC_MESSAGES/glib20.mo +0 -0
  705. data/vendor/local/share/locale/ps/LC_MESSAGES/glib20.mo +0 -0
  706. data/vendor/local/share/locale/pt/LC_MESSAGES/gettext-runtime.mo +0 -0
  707. data/vendor/local/share/locale/pt/LC_MESSAGES/glib20.mo +0 -0
  708. data/vendor/local/share/locale/pt_BR/LC_MESSAGES/gettext-runtime.mo +0 -0
  709. data/vendor/local/share/locale/pt_BR/LC_MESSAGES/glib20.mo +0 -0
  710. data/vendor/local/share/locale/ro/LC_MESSAGES/gettext-runtime.mo +0 -0
  711. data/vendor/local/share/locale/ro/LC_MESSAGES/glib20.mo +0 -0
  712. data/vendor/local/share/locale/ru/LC_MESSAGES/gettext-runtime.mo +0 -0
  713. data/vendor/local/share/locale/ru/LC_MESSAGES/glib20.mo +0 -0
  714. data/vendor/local/share/locale/rw/LC_MESSAGES/glib20.mo +0 -0
  715. data/vendor/local/share/locale/si/LC_MESSAGES/glib20.mo +0 -0
  716. data/vendor/local/share/locale/sk/LC_MESSAGES/gettext-runtime.mo +0 -0
  717. data/vendor/local/share/locale/sk/LC_MESSAGES/glib20.mo +0 -0
  718. data/vendor/local/share/locale/sl/LC_MESSAGES/gettext-runtime.mo +0 -0
  719. data/vendor/local/share/locale/sl/LC_MESSAGES/glib20.mo +0 -0
  720. data/vendor/local/share/locale/sq/LC_MESSAGES/glib20.mo +0 -0
  721. data/vendor/local/share/locale/sr/LC_MESSAGES/gettext-runtime.mo +0 -0
  722. data/vendor/local/share/locale/sr/LC_MESSAGES/glib20.mo +0 -0
  723. data/vendor/local/share/locale/sr@ije/LC_MESSAGES/glib20.mo +0 -0
  724. data/vendor/local/share/locale/sr@latin/LC_MESSAGES/glib20.mo +0 -0
  725. data/vendor/local/share/locale/sv/LC_MESSAGES/gettext-runtime.mo +0 -0
  726. data/vendor/local/share/locale/sv/LC_MESSAGES/glib20.mo +0 -0
  727. data/vendor/local/share/locale/ta/LC_MESSAGES/glib20.mo +0 -0
  728. data/vendor/local/share/locale/te/LC_MESSAGES/glib20.mo +0 -0
  729. data/vendor/local/share/locale/th/LC_MESSAGES/glib20.mo +0 -0
  730. data/vendor/local/share/locale/tl/LC_MESSAGES/glib20.mo +0 -0
  731. data/vendor/local/share/locale/tr/LC_MESSAGES/gettext-runtime.mo +0 -0
  732. data/vendor/local/share/locale/tr/LC_MESSAGES/glib20.mo +0 -0
  733. data/vendor/local/share/locale/tt/LC_MESSAGES/glib20.mo +0 -0
  734. data/vendor/local/share/locale/uk/LC_MESSAGES/gettext-runtime.mo +0 -0
  735. data/vendor/local/share/locale/uk/LC_MESSAGES/glib20.mo +0 -0
  736. data/vendor/local/share/locale/vi/LC_MESSAGES/gettext-runtime.mo +0 -0
  737. data/vendor/local/share/locale/vi/LC_MESSAGES/glib20.mo +0 -0
  738. data/vendor/local/share/locale/wa/LC_MESSAGES/glib20.mo +0 -0
  739. data/vendor/local/share/locale/xh/LC_MESSAGES/glib20.mo +0 -0
  740. data/vendor/local/share/locale/yi/LC_MESSAGES/glib20.mo +0 -0
  741. data/vendor/local/share/locale/zh_CN/LC_MESSAGES/gettext-runtime.mo +0 -0
  742. data/vendor/local/share/locale/zh_CN/LC_MESSAGES/glib20.mo +0 -0
  743. data/vendor/local/share/locale/zh_HK/LC_MESSAGES/gettext-runtime.mo +0 -0
  744. data/vendor/local/share/locale/zh_HK/LC_MESSAGES/glib20.mo +0 -0
  745. data/vendor/local/share/locale/zh_TW/LC_MESSAGES/gettext-runtime.mo +0 -0
  746. data/vendor/local/share/locale/zh_TW/LC_MESSAGES/glib20.mo +0 -0
  747. data/vendor/local/share/man/man1/envsubst.1 +0 -54
  748. data/vendor/local/share/man/man1/gettext.1 +0 -69
  749. data/vendor/local/share/man/man1/glib-genmarshal.1 +0 -312
  750. data/vendor/local/share/man/man1/glib-mkenums.1 +0 -246
  751. data/vendor/local/share/man/man1/gobject-query.1 +0 -83
  752. data/vendor/local/share/man/man1/ngettext.1 +0 -68
  753. data/vendor/local/share/man/man3/bind_textdomain_codeset.3 +0 -72
  754. data/vendor/local/share/man/man3/bindtextdomain.3 +0 -69
  755. data/vendor/local/share/man/man3/dcgettext.3 +0 -1
  756. data/vendor/local/share/man/man3/dcngettext.3 +0 -1
  757. data/vendor/local/share/man/man3/dgettext.3 +0 -1
  758. data/vendor/local/share/man/man3/dngettext.3 +0 -1
  759. data/vendor/local/share/man/man3/gettext.3 +0 -99
  760. data/vendor/local/share/man/man3/ngettext.3 +0 -60
  761. data/vendor/local/share/man/man3/textdomain.3 +0 -57
  762. data/vendor/local/src/tml/packaging/gettext_0.18.1.1-2_win32.log +0 -10423
  763. data/vendor/local/src/tml/packaging/gettext_0.18.1.1-2_win32.sh +0 -457
  764. data/vendor/local/src/tml/packaging/glib_2.26.0-2_win32.log +0 -2867
  765. data/vendor/local/src/tml/packaging/glib_2.26.0-2_win32.sh +0 -64
@@ -1,2045 +0,0 @@
1
- <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
- <html>
3
- <head>
4
- <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
- <title>Date and Time Functions</title>
6
- <meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
7
- <link rel="home" href="index.html" title="GLib Reference Manual">
8
- <link rel="up" href="glib-utilities.html" title="GLib Utilities">
9
- <link rel="prev" href="glib-I18N.html" title="Internationalization">
10
- <link rel="next" href="glib-GTimeZone.html" title="GTimeZone">
11
- <meta name="generator" content="GTK-Doc V1.15.1 (XML mode)">
12
- <link rel="stylesheet" href="style.css" type="text/css">
13
- </head>
14
- <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
- <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
16
- <tr valign="middle">
17
- <td><a accesskey="p" href="glib-I18N.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18
- <td><a accesskey="u" href="glib-utilities.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19
- <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20
- <th width="100%" align="center">GLib Reference Manual</th>
21
- <td><a accesskey="n" href="glib-GTimeZone.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
22
- </tr>
23
- <tr><td colspan="5" class="shortcuts">
24
- <a href="#glib-Date-and-Time-Functions.synopsis" class="shortcut">Top</a>
25
-  | 
26
- <a href="#glib-Date-and-Time-Functions.description" class="shortcut">Description</a>
27
- </td></tr>
28
- </table>
29
- <div class="refentry">
30
- <a name="glib-Date-and-Time-Functions"></a><div class="titlepage"></div>
31
- <div class="refnamediv"><table width="100%"><tr>
32
- <td valign="top">
33
- <h2><span class="refentrytitle"><a name="glib-Date-and-Time-Functions.top_of_page"></a>Date and Time Functions</span></h2>
34
- <p>Date and Time Functions — calendrical calculations and miscellaneous time stuff</p>
35
- </td>
36
- <td valign="top" align="right"></td>
37
- </tr></table></div>
38
- <div class="refsynopsisdiv">
39
- <a name="glib-Date-and-Time-Functions.synopsis"></a><h2>Synopsis</h2>
40
- <pre class="synopsis">
41
- #include &lt;glib.h&gt;
42
-
43
- #define <a class="link" href="glib-Date-and-Time-Functions.html#G-USEC-PER-SEC:CAPS" title="G_USEC_PER_SEC">G_USEC_PER_SEC</a>
44
- <a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal">GTimeVal</a>;
45
- <span class="returnvalue">void</span> <a class="link" href="glib-Date-and-Time-Functions.html#g-get-current-time" title="g_get_current_time ()">g_get_current_time</a> (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal"><span class="type">GTimeVal</span></a> *result</code></em>);
46
- <span class="returnvalue">void</span> <a class="link" href="glib-Date-and-Time-Functions.html#g-usleep" title="g_usleep ()">g_usleep</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gulong" title="gulong"><span class="type">gulong</span></a> microseconds</code></em>);
47
- <span class="returnvalue">void</span> <a class="link" href="glib-Date-and-Time-Functions.html#g-time-val-add" title="g_time_val_add ()">g_time_val_add</a> (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal"><span class="type">GTimeVal</span></a> *time_</code></em>,
48
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> microseconds</code></em>);
49
- <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Date-and-Time-Functions.html#g-time-val-from-iso8601" title="g_time_val_from_iso8601 ()">g_time_val_from_iso8601</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *iso_date</code></em>,
50
- <em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal"><span class="type">GTimeVal</span></a> *time_</code></em>);
51
- <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-Date-and-Time-Functions.html#g-time-val-to-iso8601" title="g_time_val_to_iso8601 ()">g_time_val_to_iso8601</a> (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal"><span class="type">GTimeVal</span></a> *time_</code></em>);
52
-
53
- <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate">GDate</a>;
54
- typedef <a class="link" href="glib-Date-and-Time-Functions.html#GTime" title="GTime">GTime</a>;
55
- enum <a class="link" href="glib-Date-and-Time-Functions.html#GDateDMY" title="enum GDateDMY">GDateDMY</a>;
56
- typedef <a class="link" href="glib-Date-and-Time-Functions.html#GDateDay" title="GDateDay">GDateDay</a>;
57
- enum <a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth" title="enum GDateMonth">GDateMonth</a>;
58
- typedef <a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear">GDateYear</a>;
59
- enum <a class="link" href="glib-Date-and-Time-Functions.html#GDateWeekday" title="enum GDateWeekday">GDateWeekday</a>;
60
-
61
- #define <a class="link" href="glib-Date-and-Time-Functions.html#G-DATE-BAD-DAY:CAPS" title="G_DATE_BAD_DAY">G_DATE_BAD_DAY</a>
62
- #define <a class="link" href="glib-Date-and-Time-Functions.html#G-DATE-BAD-JULIAN:CAPS" title="G_DATE_BAD_JULIAN">G_DATE_BAD_JULIAN</a>
63
- #define <a class="link" href="glib-Date-and-Time-Functions.html#G-DATE-BAD-YEAR:CAPS" title="G_DATE_BAD_YEAR">G_DATE_BAD_YEAR</a>
64
-
65
- <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="returnvalue">GDate</span></a> * <a class="link" href="glib-Date-and-Time-Functions.html#g-date-new" title="g_date_new ()">g_date_new</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
66
- <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="returnvalue">GDate</span></a> * <a class="link" href="glib-Date-and-Time-Functions.html#g-date-new-dmy" title="g_date_new_dmy ()">g_date_new_dmy</a> (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDateDay" title="GDateDay"><span class="type">GDateDay</span></a> day</code></em>,
67
- <em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth" title="enum GDateMonth"><span class="type">GDateMonth</span></a> month</code></em>,
68
- <em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear"><span class="type">GDateYear</span></a> year</code></em>);
69
- <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="returnvalue">GDate</span></a> * <a class="link" href="glib-Date-and-Time-Functions.html#g-date-new-julian" title="g_date_new_julian ()">g_date_new_julian</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint32" title="guint32"><span class="type">guint32</span></a> julian_day</code></em>);
70
- <span class="returnvalue">void</span> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-clear" title="g_date_clear ()">g_date_clear</a> (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>,
71
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="type">guint</span></a> n_dates</code></em>);
72
- <span class="returnvalue">void</span> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-free" title="g_date_free ()">g_date_free</a> (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>);
73
-
74
- <span class="returnvalue">void</span> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-set-day" title="g_date_set_day ()">g_date_set_day</a> (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>,
75
- <em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDateDay" title="GDateDay"><span class="type">GDateDay</span></a> day</code></em>);
76
- <span class="returnvalue">void</span> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-set-month" title="g_date_set_month ()">g_date_set_month</a> (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>,
77
- <em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth" title="enum GDateMonth"><span class="type">GDateMonth</span></a> month</code></em>);
78
- <span class="returnvalue">void</span> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-set-year" title="g_date_set_year ()">g_date_set_year</a> (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>,
79
- <em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear"><span class="type">GDateYear</span></a> year</code></em>);
80
- <span class="returnvalue">void</span> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-set-dmy" title="g_date_set_dmy ()">g_date_set_dmy</a> (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>,
81
- <em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDateDay" title="GDateDay"><span class="type">GDateDay</span></a> day</code></em>,
82
- <em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth" title="enum GDateMonth"><span class="type">GDateMonth</span></a> month</code></em>,
83
- <em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear"><span class="type">GDateYear</span></a> y</code></em>);
84
- <span class="returnvalue">void</span> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-set-julian" title="g_date_set_julian ()">g_date_set_julian</a> (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>,
85
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint32" title="guint32"><span class="type">guint32</span></a> julian_date</code></em>);
86
- <span class="returnvalue">void</span> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-set-time" title="g_date_set_time ()">g_date_set_time</a> (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>,
87
- <em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GTime" title="GTime"><span class="type">GTime</span></a> time_</code></em>);
88
- <span class="returnvalue">void</span> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-set-time-t" title="g_date_set_time_t ()">g_date_set_time_t</a> (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>,
89
- <em class="parameter"><code><span class="type">time_t</span> timet</code></em>);
90
- <span class="returnvalue">void</span> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-set-time-val" title="g_date_set_time_val ()">g_date_set_time_val</a> (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>,
91
- <em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal"><span class="type">GTimeVal</span></a> *timeval</code></em>);
92
- <span class="returnvalue">void</span> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-set-parse" title="g_date_set_parse ()">g_date_set_parse</a> (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>,
93
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>);
94
-
95
- <span class="returnvalue">void</span> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-add-days" title="g_date_add_days ()">g_date_add_days</a> (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>,
96
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="type">guint</span></a> n_days</code></em>);
97
- <span class="returnvalue">void</span> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-subtract-days" title="g_date_subtract_days ()">g_date_subtract_days</a> (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>,
98
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="type">guint</span></a> n_days</code></em>);
99
- <span class="returnvalue">void</span> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-add-months" title="g_date_add_months ()">g_date_add_months</a> (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>,
100
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="type">guint</span></a> n_months</code></em>);
101
- <span class="returnvalue">void</span> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-subtract-months" title="g_date_subtract_months ()">g_date_subtract_months</a> (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>,
102
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="type">guint</span></a> n_months</code></em>);
103
- <span class="returnvalue">void</span> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-add-years" title="g_date_add_years ()">g_date_add_years</a> (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>,
104
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="type">guint</span></a> n_years</code></em>);
105
- <span class="returnvalue">void</span> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-subtract-years" title="g_date_subtract_years ()">g_date_subtract_years</a> (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>,
106
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="type">guint</span></a> n_years</code></em>);
107
- <a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-days-between" title="g_date_days_between ()">g_date_days_between</a> (<em class="parameter"><code>const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date1</code></em>,
108
- <em class="parameter"><code>const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date2</code></em>);
109
- <a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-compare" title="g_date_compare ()">g_date_compare</a> (<em class="parameter"><code>const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *lhs</code></em>,
110
- <em class="parameter"><code>const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *rhs</code></em>);
111
- <span class="returnvalue">void</span> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-clamp" title="g_date_clamp ()">g_date_clamp</a> (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>,
112
- <em class="parameter"><code>const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *min_date</code></em>,
113
- <em class="parameter"><code>const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *max_date</code></em>);
114
- <span class="returnvalue">void</span> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-order" title="g_date_order ()">g_date_order</a> (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date1</code></em>,
115
- <em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date2</code></em>);
116
-
117
- <a class="link" href="glib-Date-and-Time-Functions.html#GDateDay" title="GDateDay"><span class="returnvalue">GDateDay</span></a> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-get-day" title="g_date_get_day ()">g_date_get_day</a> (<em class="parameter"><code>const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>);
118
- <a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth" title="enum GDateMonth"><span class="returnvalue">GDateMonth</span></a> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-get-month" title="g_date_get_month ()">g_date_get_month</a> (<em class="parameter"><code>const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>);
119
- <a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear"><span class="returnvalue">GDateYear</span></a> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-get-year" title="g_date_get_year ()">g_date_get_year</a> (<em class="parameter"><code>const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>);
120
- <a class="link" href="glib-Basic-Types.html#guint32" title="guint32"><span class="returnvalue">guint32</span></a> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-get-julian" title="g_date_get_julian ()">g_date_get_julian</a> (<em class="parameter"><code>const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>);
121
- <a class="link" href="glib-Date-and-Time-Functions.html#GDateWeekday" title="enum GDateWeekday"><span class="returnvalue">GDateWeekday</span></a> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-get-weekday" title="g_date_get_weekday ()">g_date_get_weekday</a> (<em class="parameter"><code>const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>);
122
- <a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="returnvalue">guint</span></a> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-get-day-of-year" title="g_date_get_day_of_year ()">g_date_get_day_of_year</a> (<em class="parameter"><code>const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>);
123
-
124
- <a class="link" href="glib-Basic-Types.html#guint8" title="guint8"><span class="returnvalue">guint8</span></a> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-get-days-in-month" title="g_date_get_days_in_month ()">g_date_get_days_in_month</a> (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth" title="enum GDateMonth"><span class="type">GDateMonth</span></a> month</code></em>,
125
- <em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear"><span class="type">GDateYear</span></a> year</code></em>);
126
- <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-is-first-of-month" title="g_date_is_first_of_month ()">g_date_is_first_of_month</a> (<em class="parameter"><code>const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>);
127
- <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-is-last-of-month" title="g_date_is_last_of_month ()">g_date_is_last_of_month</a> (<em class="parameter"><code>const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>);
128
- <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-is-leap-year" title="g_date_is_leap_year ()">g_date_is_leap_year</a> (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear"><span class="type">GDateYear</span></a> year</code></em>);
129
- <a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="returnvalue">guint</span></a> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-get-monday-week-of-year" title="g_date_get_monday_week_of_year ()">g_date_get_monday_week_of_year</a> (<em class="parameter"><code>const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>);
130
- <a class="link" href="glib-Basic-Types.html#guint8" title="guint8"><span class="returnvalue">guint8</span></a> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-get-monday-weeks-in-year" title="g_date_get_monday_weeks_in_year ()">g_date_get_monday_weeks_in_year</a> (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear"><span class="type">GDateYear</span></a> year</code></em>);
131
- <a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="returnvalue">guint</span></a> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-get-sunday-week-of-year" title="g_date_get_sunday_week_of_year ()">g_date_get_sunday_week_of_year</a> (<em class="parameter"><code>const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>);
132
- <a class="link" href="glib-Basic-Types.html#guint8" title="guint8"><span class="returnvalue">guint8</span></a> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-get-sunday-weeks-in-year" title="g_date_get_sunday_weeks_in_year ()">g_date_get_sunday_weeks_in_year</a> (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear"><span class="type">GDateYear</span></a> year</code></em>);
133
- <a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="returnvalue">guint</span></a> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-get-iso8601-week-of-year" title="g_date_get_iso8601_week_of_year ()">g_date_get_iso8601_week_of_year</a> (<em class="parameter"><code>const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>);
134
-
135
- <a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="returnvalue">gsize</span></a> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-strftime" title="g_date_strftime ()">g_date_strftime</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *s</code></em>,
136
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> slen</code></em>,
137
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *format</code></em>,
138
- <em class="parameter"><code>const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>);
139
- <span class="returnvalue">void</span> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-to-struct-tm" title="g_date_to_struct_tm ()">g_date_to_struct_tm</a> (<em class="parameter"><code>const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>,
140
- <em class="parameter"><code><span class="type">struct tm</span> *tm</code></em>);
141
-
142
- <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-valid" title="g_date_valid ()">g_date_valid</a> (<em class="parameter"><code>const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>);
143
- <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-valid-day" title="g_date_valid_day ()">g_date_valid_day</a> (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDateDay" title="GDateDay"><span class="type">GDateDay</span></a> day</code></em>);
144
- <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-valid-month" title="g_date_valid_month ()">g_date_valid_month</a> (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth" title="enum GDateMonth"><span class="type">GDateMonth</span></a> month</code></em>);
145
- <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-valid-year" title="g_date_valid_year ()">g_date_valid_year</a> (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear"><span class="type">GDateYear</span></a> year</code></em>);
146
- <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-valid-dmy" title="g_date_valid_dmy ()">g_date_valid_dmy</a> (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDateDay" title="GDateDay"><span class="type">GDateDay</span></a> day</code></em>,
147
- <em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth" title="enum GDateMonth"><span class="type">GDateMonth</span></a> month</code></em>,
148
- <em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear"><span class="type">GDateYear</span></a> year</code></em>);
149
- <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-valid-julian" title="g_date_valid_julian ()">g_date_valid_julian</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint32" title="guint32"><span class="type">guint32</span></a> julian_date</code></em>);
150
- <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Date-and-Time-Functions.html#g-date-valid-weekday" title="g_date_valid_weekday ()">g_date_valid_weekday</a> (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDateWeekday" title="enum GDateWeekday"><span class="type">GDateWeekday</span></a> weekday</code></em>);
151
- </pre>
152
- </div>
153
- <div class="refsect1">
154
- <a name="glib-Date-and-Time-Functions.description"></a><h2>Description</h2>
155
- <p>
156
- The <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> data structure represents a day between January 1, Year 1,
157
- and sometime a few thousand years in the future (right now it will go
158
- to the year 65535 or so, but <a class="link" href="glib-Date-and-Time-Functions.html#g-date-set-parse" title="g_date_set_parse ()"><code class="function">g_date_set_parse()</code></a> only parses up to the
159
- year 8000 or so - just count on "a few thousand"). <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> is meant to
160
- represent everyday dates, not astronomical dates or historical dates
161
- or ISO timestamps or the like. It extrapolates the current Gregorian
162
- calendar forward and backward in time; there is no attempt to change
163
- the calendar to match time periods or locations. <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> does not store
164
- time information; it represents a <span class="emphasis"><em>day</em></span>.
165
- </p>
166
- <p>
167
- The <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> implementation has several nice features; it is only a
168
- 64-bit struct, so storing large numbers of dates is very efficient. It
169
- can keep both a Julian and day-month-year representation of the date,
170
- since some calculations are much easier with one representation or the
171
- other. A Julian representation is simply a count of days since some
172
- fixed day in the past; for <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> the fixed day is January 1, 1 AD.
173
- ("Julian" dates in the <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> API aren't really Julian dates in the
174
- technical sense; technically, Julian dates count from the start of the
175
- Julian period, Jan 1, 4713 BC).
176
- </p>
177
- <p>
178
- <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> is simple to use. First you need a "blank" date; you can get a
179
- dynamically allocated date from <a class="link" href="glib-Date-and-Time-Functions.html#g-date-new" title="g_date_new ()"><code class="function">g_date_new()</code></a>, or you can declare an
180
- automatic variable or array and initialize it to a sane state by
181
- calling <a class="link" href="glib-Date-and-Time-Functions.html#g-date-clear" title="g_date_clear ()"><code class="function">g_date_clear()</code></a>. A cleared date is sane; it's safe to call
182
- <a class="link" href="glib-Date-and-Time-Functions.html#g-date-set-dmy" title="g_date_set_dmy ()"><code class="function">g_date_set_dmy()</code></a> and the other mutator functions to initialize the
183
- value of a cleared date. However, a cleared date is initially
184
- <span class="emphasis"><em>invalid</em></span>, meaning that it doesn't represent a day
185
- that exists. It is undefined to call any of the date calculation
186
- routines on an invalid date. If you obtain a date from a user or other
187
- unpredictable source, you should check its validity with the
188
- <a class="link" href="glib-Date-and-Time-Functions.html#g-date-valid" title="g_date_valid ()"><code class="function">g_date_valid()</code></a> predicate. <a class="link" href="glib-Date-and-Time-Functions.html#g-date-valid" title="g_date_valid ()"><code class="function">g_date_valid()</code></a> is also used to check for
189
- errors with <a class="link" href="glib-Date-and-Time-Functions.html#g-date-set-parse" title="g_date_set_parse ()"><code class="function">g_date_set_parse()</code></a> and other functions that can
190
- fail. Dates can be invalidated by calling <a class="link" href="glib-Date-and-Time-Functions.html#g-date-clear" title="g_date_clear ()"><code class="function">g_date_clear()</code></a> again.
191
- </p>
192
- <p>
193
- <span class="emphasis"><em>It is very important to use the API to access the <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>
194
- struct.</em></span> Often only the day-month-year or only the Julian
195
- representation is valid. Sometimes neither is valid. Use the API.
196
- </p>
197
- <p>
198
- GLib doesn't contain any time-manipulation functions; however, there
199
- is a <a class="link" href="glib-Date-and-Time-Functions.html#GTime" title="GTime"><span class="type">GTime</span></a> typedef and a <a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal"><span class="type">GTimeVal</span></a> struct which represents a more
200
- precise time (with microseconds). You can request the current time as
201
- a <a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal"><span class="type">GTimeVal</span></a> with <a class="link" href="glib-Date-and-Time-Functions.html#g-get-current-time" title="g_get_current_time ()"><code class="function">g_get_current_time()</code></a>.
202
- </p>
203
- </div>
204
- <div class="refsect1">
205
- <a name="glib-Date-and-Time-Functions.details"></a><h2>Details</h2>
206
- <div class="refsect2">
207
- <a name="G-USEC-PER-SEC:CAPS"></a><h3>G_USEC_PER_SEC</h3>
208
- <pre class="programlisting">#define G_USEC_PER_SEC 1000000
209
- </pre>
210
- <p>
211
- Number of microseconds in one second (1 million). This macro is provided for
212
- code readability.
213
- </p>
214
- </div>
215
- <hr>
216
- <div class="refsect2">
217
- <a name="GTimeVal"></a><h3>GTimeVal</h3>
218
- <pre class="programlisting">typedef struct {
219
- glong tv_sec;
220
- glong tv_usec;
221
- } GTimeVal;
222
- </pre>
223
- <p>
224
- Represents a precise time, with seconds and microseconds.
225
- Similar to the <span class="structname">struct timeval</span> returned by
226
- the <code class="function"><code class="function">gettimeofday()</code></code> UNIX call.
227
- </p>
228
- <div class="variablelist"><table border="0">
229
- <col align="left" valign="top">
230
- <tbody>
231
- <tr>
232
- <td><p><span class="term"><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> <em class="structfield"><code><a name="GTimeVal.tv-sec"></a>tv_sec</code></em>;</span></p></td>
233
- <td>seconds
234
- </td>
235
- </tr>
236
- <tr>
237
- <td><p><span class="term"><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> <em class="structfield"><code><a name="GTimeVal.tv-usec"></a>tv_usec</code></em>;</span></p></td>
238
- <td>microseconds
239
- </td>
240
- </tr>
241
- </tbody>
242
- </table></div>
243
- </div>
244
- <hr>
245
- <div class="refsect2">
246
- <a name="g-get-current-time"></a><h3>g_get_current_time ()</h3>
247
- <pre class="programlisting"><span class="returnvalue">void</span> g_get_current_time (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal"><span class="type">GTimeVal</span></a> *result</code></em>);</pre>
248
- <p>
249
- Equivalent to the UNIX <code class="function">gettimeofday()</code> function, but portable.
250
- </p>
251
- <div class="variablelist"><table border="0">
252
- <col align="left" valign="top">
253
- <tbody><tr>
254
- <td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
255
- <td>
256
- <a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal"><span class="type">GTimeVal</span></a> structure in which to store current time.
257
- </td>
258
- </tr></tbody>
259
- </table></div>
260
- </div>
261
- <hr>
262
- <div class="refsect2">
263
- <a name="g-usleep"></a><h3>g_usleep ()</h3>
264
- <pre class="programlisting"><span class="returnvalue">void</span> g_usleep (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gulong" title="gulong"><span class="type">gulong</span></a> microseconds</code></em>);</pre>
265
- <p>
266
- Pauses the current thread for the given number of microseconds. There
267
- are 1 million microseconds per second (represented by the
268
- <a class="link" href="glib-Date-and-Time-Functions.html#G-USEC-PER-SEC:CAPS" title="G_USEC_PER_SEC"><span class="type">G_USEC_PER_SEC</span></a> macro). <a class="link" href="glib-Date-and-Time-Functions.html#g-usleep" title="g_usleep ()"><code class="function">g_usleep()</code></a> may have limited precision,
269
- depending on hardware and operating system; don't rely on the exact
270
- length of the sleep.
271
- </p>
272
- <div class="variablelist"><table border="0">
273
- <col align="left" valign="top">
274
- <tbody><tr>
275
- <td><p><span class="term"><em class="parameter"><code>microseconds</code></em> :</span></p></td>
276
- <td>number of microseconds to pause
277
- </td>
278
- </tr></tbody>
279
- </table></div>
280
- </div>
281
- <hr>
282
- <div class="refsect2">
283
- <a name="g-time-val-add"></a><h3>g_time_val_add ()</h3>
284
- <pre class="programlisting"><span class="returnvalue">void</span> g_time_val_add (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal"><span class="type">GTimeVal</span></a> *time_</code></em>,
285
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> microseconds</code></em>);</pre>
286
- <p>
287
- Adds the given number of microseconds to <em class="parameter"><code>time_</code></em>. <em class="parameter"><code>microseconds</code></em> can
288
- also be negative to decrease the value of <em class="parameter"><code>time_</code></em>.
289
- </p>
290
- <div class="variablelist"><table border="0">
291
- <col align="left" valign="top">
292
- <tbody>
293
- <tr>
294
- <td><p><span class="term"><em class="parameter"><code>time_</code></em> :</span></p></td>
295
- <td>a <a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal"><span class="type">GTimeVal</span></a>
296
- </td>
297
- </tr>
298
- <tr>
299
- <td><p><span class="term"><em class="parameter"><code>microseconds</code></em> :</span></p></td>
300
- <td>number of microseconds to add to <em class="parameter"><code>time</code></em>
301
- </td>
302
- </tr>
303
- </tbody>
304
- </table></div>
305
- </div>
306
- <hr>
307
- <div class="refsect2">
308
- <a name="g-time-val-from-iso8601"></a><h3>g_time_val_from_iso8601 ()</h3>
309
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_time_val_from_iso8601 (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *iso_date</code></em>,
310
- <em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal"><span class="type">GTimeVal</span></a> *time_</code></em>);</pre>
311
- <p>
312
- Converts a string containing an ISO 8601 encoded date and time
313
- to a <a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal"><span class="type">GTimeVal</span></a> and puts it into <em class="parameter"><code>time_</code></em>.
314
- </p>
315
- <div class="variablelist"><table border="0">
316
- <col align="left" valign="top">
317
- <tbody>
318
- <tr>
319
- <td><p><span class="term"><em class="parameter"><code>iso_date</code></em> :</span></p></td>
320
- <td>an ISO 8601 encoded date string
321
- </td>
322
- </tr>
323
- <tr>
324
- <td><p><span class="term"><em class="parameter"><code>time_</code></em> :</span></p></td>
325
- <td>a <a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal"><span class="type">GTimeVal</span></a>
326
- </td>
327
- </tr>
328
- <tr>
329
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
330
- <td> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the conversion was successful.
331
-
332
- </td>
333
- </tr>
334
- </tbody>
335
- </table></div>
336
- <p class="since">Since 2.12</p>
337
- </div>
338
- <hr>
339
- <div class="refsect2">
340
- <a name="g-time-val-to-iso8601"></a><h3>g_time_val_to_iso8601 ()</h3>
341
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_time_val_to_iso8601 (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal"><span class="type">GTimeVal</span></a> *time_</code></em>);</pre>
342
- <p>
343
- Converts <em class="parameter"><code>time_</code></em> into an ISO 8601 encoded string, relative to the
344
- Coordinated Universal Time (UTC).
345
- </p>
346
- <div class="variablelist"><table border="0">
347
- <col align="left" valign="top">
348
- <tbody>
349
- <tr>
350
- <td><p><span class="term"><em class="parameter"><code>time_</code></em> :</span></p></td>
351
- <td>a <a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal"><span class="type">GTimeVal</span></a>
352
- </td>
353
- </tr>
354
- <tr>
355
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
356
- <td> a newly allocated string containing an ISO 8601 date
357
-
358
- </td>
359
- </tr>
360
- </tbody>
361
- </table></div>
362
- <p class="since">Since 2.12</p>
363
- </div>
364
- <hr>
365
- <div class="refsect2">
366
- <a name="GDate"></a><h3>GDate</h3>
367
- <pre class="programlisting">typedef struct {
368
- guint julian_days : 32; /* julian days representation - we use a
369
- * bitfield hoping that 64 bit platforms
370
- * will pack this whole struct in one big
371
- * int
372
- */
373
-
374
- guint julian : 1; /* julian is valid */
375
- guint dmy : 1; /* dmy is valid */
376
-
377
- /* DMY representation */
378
- guint day : 6;
379
- guint month : 4;
380
- guint year : 16;
381
- } GDate;
382
- </pre>
383
- <p>
384
- Represents a day between January 1, Year 1 and a few thousand years in
385
- the future. None of its members should be accessed directly. If the
386
- <span class="structname">GDate</span> is obtained from <a class="link" href="glib-Date-and-Time-Functions.html#g-date-new" title="g_date_new ()"><code class="function">g_date_new()</code></a>, it will
387
- be safe to mutate but invalid and thus not safe for calendrical computations.
388
- If it's declared on the stack, it will contain garbage so must be
389
- initialized with <a class="link" href="glib-Date-and-Time-Functions.html#g-date-clear" title="g_date_clear ()"><code class="function">g_date_clear()</code></a>. <a class="link" href="glib-Date-and-Time-Functions.html#g-date-clear" title="g_date_clear ()"><code class="function">g_date_clear()</code></a> makes the date invalid
390
- but sane. An invalid date doesn't represent a day, it's "empty." A
391
- date becomes valid after you set it to a Julian day or you set a day,
392
- month, and year.
393
- </p>
394
- <div class="variablelist"><table border="0">
395
- <col align="left" valign="top">
396
- <tbody>
397
- <tr>
398
- <td><p><span class="term"><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="GDate.julian-days"></a>julian_days</code></em> : 32;</span></p></td>
399
- <td>the Julian representation of the date
400
- </td>
401
- </tr>
402
- <tr>
403
- <td><p><span class="term"><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="GDate.julian"></a>julian</code></em> : 1;</span></p></td>
404
- <td>this bit is set if <em class="parameter"><code>julian_days</code></em> is valid
405
- </td>
406
- </tr>
407
- <tr>
408
- <td><p><span class="term"><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="GDate.dmy"></a>dmy</code></em> : 1;</span></p></td>
409
- <td>this is set if <em class="parameter"><code>day</code></em>, <em class="parameter"><code>month</code></em> and <em class="parameter"><code>year</code></em> are valid
410
- </td>
411
- </tr>
412
- <tr>
413
- <td><p><span class="term"><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="GDate.day"></a>day</code></em> : 6;</span></p></td>
414
- <td>the day of the day-month-year representation of the date, as
415
- a number between 1 and 31
416
- </td>
417
- </tr>
418
- <tr>
419
- <td><p><span class="term"><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="GDate.month"></a>month</code></em> : 4;</span></p></td>
420
- <td>the day of the day-month-year representation of the date, as
421
- a number between 1 and 12
422
- </td>
423
- </tr>
424
- <tr>
425
- <td><p><span class="term"><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="GDate.year"></a>year</code></em> : 16;</span></p></td>
426
- <td>the day of the day-month-year representation of the date
427
- </td>
428
- </tr>
429
- </tbody>
430
- </table></div>
431
- </div>
432
- <hr>
433
- <div class="refsect2">
434
- <a name="GTime"></a><h3>GTime</h3>
435
- <pre class="programlisting">typedef gint32 GTime;
436
- </pre>
437
- <p>
438
- Simply a replacement for <span class="type">time_t</span>. It has been deprected
439
- since it is <span class="emphasis"><em>not</em></span> equivalent to <span class="type">time_t</span>
440
- on 64-bit platforms with a 64-bit <span class="type">time_t</span>.
441
- Unrelated to <a class="link" href="glib-Timers.html#GTimer" title="GTimer"><span class="type">GTimer</span></a>.
442
- </p>
443
- <p>
444
- Note that <span class="type">GTime</span> is defined to always be a 32bit integer,
445
- unlike <span class="type">time_t</span> which may be 64bit on some systems.
446
- Therefore, <span class="type">GTime</span> will overflow in the year 2038, and
447
- you cannot use the address of a <span class="type">GTime</span> variable as argument
448
- to the UNIX <code class="function">time()</code> function. Instead, do the following:
449
- </p>
450
- <div class="informalexample">
451
- <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
452
- <tbody>
453
- <tr>
454
- <td class="listing_lines" align="right"><pre>1
455
- 2
456
- 3
457
- 4</pre></td>
458
- <td class="listing_code"><pre class="programlisting"><span class="usertype">time_t</span><span class="normal"> ttime</span><span class="symbol">;</span>
459
- <span class="usertype">GTime</span><span class="normal"> gtime</span><span class="symbol">;</span>
460
- <span class="function">time</span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">ttime</span><span class="symbol">);</span>
461
- <span class="normal">gtime </span><span class="symbol">=</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="glib-Date-and-Time-Functions.html#GTime">GTime</a></span><span class="symbol">)</span><span class="normal">ttime</span><span class="symbol">;</span></pre></td>
462
- </tr>
463
- </tbody>
464
- </table>
465
- </div>
466
-
467
- <p>
468
- </p>
469
- </div>
470
- <hr>
471
- <div class="refsect2">
472
- <a name="GDateDMY"></a><h3>enum GDateDMY</h3>
473
- <pre class="programlisting">typedef enum
474
- {
475
- G_DATE_DAY = 0,
476
- G_DATE_MONTH = 1,
477
- G_DATE_YEAR = 2
478
- } GDateDMY;
479
- </pre>
480
- <p>
481
- This enumeration isn't used in the API, but may be useful if you need
482
- to mark a number as a day, month, or year.
483
- </p>
484
- <div class="variablelist"><table border="0">
485
- <col align="left" valign="top">
486
- <tbody>
487
- <tr>
488
- <td><p><a name="G-DATE-DAY:CAPS"></a><span class="term"><code class="literal">G_DATE_DAY</code></span></p></td>
489
- <td>a day
490
- </td>
491
- </tr>
492
- <tr>
493
- <td><p><a name="G-DATE-MONTH:CAPS"></a><span class="term"><code class="literal">G_DATE_MONTH</code></span></p></td>
494
- <td>a month
495
- </td>
496
- </tr>
497
- <tr>
498
- <td><p><a name="G-DATE-YEAR:CAPS"></a><span class="term"><code class="literal">G_DATE_YEAR</code></span></p></td>
499
- <td>a year
500
- </td>
501
- </tr>
502
- </tbody>
503
- </table></div>
504
- </div>
505
- <hr>
506
- <div class="refsect2">
507
- <a name="GDateDay"></a><h3>GDateDay</h3>
508
- <pre class="programlisting">typedef guint8 GDateDay; /* day of the month */
509
- </pre>
510
- <p>
511
- Integer representing a day of the month; between 1 and
512
- 31. <a class="link" href="glib-Date-and-Time-Functions.html#G-DATE-BAD-DAY:CAPS" title="G_DATE_BAD_DAY"><span class="type">G_DATE_BAD_DAY</span></a> represents an invalid day of the month.
513
- </p>
514
- </div>
515
- <hr>
516
- <div class="refsect2">
517
- <a name="GDateMonth"></a><h3>enum GDateMonth</h3>
518
- <pre class="programlisting">typedef enum
519
- {
520
- G_DATE_BAD_MONTH = 0,
521
- G_DATE_JANUARY = 1,
522
- G_DATE_FEBRUARY = 2,
523
- G_DATE_MARCH = 3,
524
- G_DATE_APRIL = 4,
525
- G_DATE_MAY = 5,
526
- G_DATE_JUNE = 6,
527
- G_DATE_JULY = 7,
528
- G_DATE_AUGUST = 8,
529
- G_DATE_SEPTEMBER = 9,
530
- G_DATE_OCTOBER = 10,
531
- G_DATE_NOVEMBER = 11,
532
- G_DATE_DECEMBER = 12
533
- } GDateMonth;
534
- </pre>
535
- <p>
536
- Enumeration representing a month; values are <a class="link" href="glib-Date-and-Time-Functions.html#G-DATE-JANUARY:CAPS"><span class="type">G_DATE_JANUARY</span></a>,
537
- <a class="link" href="glib-Date-and-Time-Functions.html#G-DATE-FEBRUARY:CAPS"><span class="type">G_DATE_FEBRUARY</span></a>, etc. <a class="link" href="glib-Date-and-Time-Functions.html#G-DATE-BAD-MONTH:CAPS"><span class="type">G_DATE_BAD_MONTH</span></a> is the invalid value.
538
- </p>
539
- <div class="variablelist"><table border="0">
540
- <col align="left" valign="top">
541
- <tbody>
542
- <tr>
543
- <td><p><a name="G-DATE-BAD-MONTH:CAPS"></a><span class="term"><code class="literal">G_DATE_BAD_MONTH</code></span></p></td>
544
- <td>invalid value
545
- </td>
546
- </tr>
547
- <tr>
548
- <td><p><a name="G-DATE-JANUARY:CAPS"></a><span class="term"><code class="literal">G_DATE_JANUARY</code></span></p></td>
549
- <td>January
550
- </td>
551
- </tr>
552
- <tr>
553
- <td><p><a name="G-DATE-FEBRUARY:CAPS"></a><span class="term"><code class="literal">G_DATE_FEBRUARY</code></span></p></td>
554
- <td>February
555
- </td>
556
- </tr>
557
- <tr>
558
- <td><p><a name="G-DATE-MARCH:CAPS"></a><span class="term"><code class="literal">G_DATE_MARCH</code></span></p></td>
559
- <td>March
560
- </td>
561
- </tr>
562
- <tr>
563
- <td><p><a name="G-DATE-APRIL:CAPS"></a><span class="term"><code class="literal">G_DATE_APRIL</code></span></p></td>
564
- <td>April
565
- </td>
566
- </tr>
567
- <tr>
568
- <td><p><a name="G-DATE-MAY:CAPS"></a><span class="term"><code class="literal">G_DATE_MAY</code></span></p></td>
569
- <td>May
570
- </td>
571
- </tr>
572
- <tr>
573
- <td><p><a name="G-DATE-JUNE:CAPS"></a><span class="term"><code class="literal">G_DATE_JUNE</code></span></p></td>
574
- <td>June
575
- </td>
576
- </tr>
577
- <tr>
578
- <td><p><a name="G-DATE-JULY:CAPS"></a><span class="term"><code class="literal">G_DATE_JULY</code></span></p></td>
579
- <td>July
580
- </td>
581
- </tr>
582
- <tr>
583
- <td><p><a name="G-DATE-AUGUST:CAPS"></a><span class="term"><code class="literal">G_DATE_AUGUST</code></span></p></td>
584
- <td>August
585
- </td>
586
- </tr>
587
- <tr>
588
- <td><p><a name="G-DATE-SEPTEMBER:CAPS"></a><span class="term"><code class="literal">G_DATE_SEPTEMBER</code></span></p></td>
589
- <td>September
590
- </td>
591
- </tr>
592
- <tr>
593
- <td><p><a name="G-DATE-OCTOBER:CAPS"></a><span class="term"><code class="literal">G_DATE_OCTOBER</code></span></p></td>
594
- <td>October
595
- </td>
596
- </tr>
597
- <tr>
598
- <td><p><a name="G-DATE-NOVEMBER:CAPS"></a><span class="term"><code class="literal">G_DATE_NOVEMBER</code></span></p></td>
599
- <td>November
600
- </td>
601
- </tr>
602
- <tr>
603
- <td><p><a name="G-DATE-DECEMBER:CAPS"></a><span class="term"><code class="literal">G_DATE_DECEMBER</code></span></p></td>
604
- <td>December
605
- </td>
606
- </tr>
607
- </tbody>
608
- </table></div>
609
- </div>
610
- <hr>
611
- <div class="refsect2">
612
- <a name="GDateYear"></a><h3>GDateYear</h3>
613
- <pre class="programlisting">typedef guint16 GDateYear;
614
- </pre>
615
- <p>
616
- Integer representing a year; <a class="link" href="glib-Date-and-Time-Functions.html#G-DATE-BAD-YEAR:CAPS" title="G_DATE_BAD_YEAR"><span class="type">G_DATE_BAD_YEAR</span></a> is the invalid
617
- value. The year must be 1 or higher; negative (BC) years are not
618
- allowed. The year is represented with four digits.
619
- </p>
620
- </div>
621
- <hr>
622
- <div class="refsect2">
623
- <a name="GDateWeekday"></a><h3>enum GDateWeekday</h3>
624
- <pre class="programlisting">typedef enum
625
- {
626
- G_DATE_BAD_WEEKDAY = 0,
627
- G_DATE_MONDAY = 1,
628
- G_DATE_TUESDAY = 2,
629
- G_DATE_WEDNESDAY = 3,
630
- G_DATE_THURSDAY = 4,
631
- G_DATE_FRIDAY = 5,
632
- G_DATE_SATURDAY = 6,
633
- G_DATE_SUNDAY = 7
634
- } GDateWeekday;
635
- </pre>
636
- <p>
637
- Enumeration representing a day of the week; <a class="link" href="glib-Date-and-Time-Functions.html#G-DATE-MONDAY:CAPS"><span class="type">G_DATE_MONDAY</span></a>,
638
- <a class="link" href="glib-Date-and-Time-Functions.html#G-DATE-TUESDAY:CAPS"><span class="type">G_DATE_TUESDAY</span></a>, etc. <a class="link" href="glib-Date-and-Time-Functions.html#G-DATE-BAD-WEEKDAY:CAPS"><span class="type">G_DATE_BAD_WEEKDAY</span></a> is an invalid weekday.
639
- </p>
640
- <div class="variablelist"><table border="0">
641
- <col align="left" valign="top">
642
- <tbody>
643
- <tr>
644
- <td><p><a name="G-DATE-BAD-WEEKDAY:CAPS"></a><span class="term"><code class="literal">G_DATE_BAD_WEEKDAY</code></span></p></td>
645
- <td>invalid value
646
- </td>
647
- </tr>
648
- <tr>
649
- <td><p><a name="G-DATE-MONDAY:CAPS"></a><span class="term"><code class="literal">G_DATE_MONDAY</code></span></p></td>
650
- <td>Monday
651
- </td>
652
- </tr>
653
- <tr>
654
- <td><p><a name="G-DATE-TUESDAY:CAPS"></a><span class="term"><code class="literal">G_DATE_TUESDAY</code></span></p></td>
655
- <td>Tuesday
656
- </td>
657
- </tr>
658
- <tr>
659
- <td><p><a name="G-DATE-WEDNESDAY:CAPS"></a><span class="term"><code class="literal">G_DATE_WEDNESDAY</code></span></p></td>
660
- <td>Wednesday
661
- </td>
662
- </tr>
663
- <tr>
664
- <td><p><a name="G-DATE-THURSDAY:CAPS"></a><span class="term"><code class="literal">G_DATE_THURSDAY</code></span></p></td>
665
- <td>Thursday
666
- </td>
667
- </tr>
668
- <tr>
669
- <td><p><a name="G-DATE-FRIDAY:CAPS"></a><span class="term"><code class="literal">G_DATE_FRIDAY</code></span></p></td>
670
- <td>Friday
671
- </td>
672
- </tr>
673
- <tr>
674
- <td><p><a name="G-DATE-SATURDAY:CAPS"></a><span class="term"><code class="literal">G_DATE_SATURDAY</code></span></p></td>
675
- <td>Saturday
676
- </td>
677
- </tr>
678
- <tr>
679
- <td><p><a name="G-DATE-SUNDAY:CAPS"></a><span class="term"><code class="literal">G_DATE_SUNDAY</code></span></p></td>
680
- <td>Sunday
681
- </td>
682
- </tr>
683
- </tbody>
684
- </table></div>
685
- </div>
686
- <hr>
687
- <div class="refsect2">
688
- <a name="G-DATE-BAD-DAY:CAPS"></a><h3>G_DATE_BAD_DAY</h3>
689
- <pre class="programlisting">#define G_DATE_BAD_DAY 0U
690
- </pre>
691
- <p>
692
- Represents an invalid <a class="link" href="glib-Date-and-Time-Functions.html#GDateDay" title="GDateDay"><span class="type">GDateDay</span></a>.
693
- </p>
694
- </div>
695
- <hr>
696
- <div class="refsect2">
697
- <a name="G-DATE-BAD-JULIAN:CAPS"></a><h3>G_DATE_BAD_JULIAN</h3>
698
- <pre class="programlisting">#define G_DATE_BAD_JULIAN 0U
699
- </pre>
700
- <p>
701
- Represents an invalid Julian day number.
702
- </p>
703
- </div>
704
- <hr>
705
- <div class="refsect2">
706
- <a name="G-DATE-BAD-YEAR:CAPS"></a><h3>G_DATE_BAD_YEAR</h3>
707
- <pre class="programlisting">#define G_DATE_BAD_YEAR 0U
708
- </pre>
709
- <p>
710
- Represents an invalid year.
711
- </p>
712
- </div>
713
- <hr>
714
- <div class="refsect2">
715
- <a name="g-date-new"></a><h3>g_date_new ()</h3>
716
- <pre class="programlisting"><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="returnvalue">GDate</span></a> * g_date_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
717
- <p>
718
- Allocates a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> and initializes it to a sane state. The new date will
719
- be cleared (as if you'd called <a class="link" href="glib-Date-and-Time-Functions.html#g-date-clear" title="g_date_clear ()"><code class="function">g_date_clear()</code></a>) but invalid (it won't
720
- represent an existing day). Free the return value with <a class="link" href="glib-Date-and-Time-Functions.html#g-date-free" title="g_date_free ()"><code class="function">g_date_free()</code></a>.
721
- </p>
722
- <div class="variablelist"><table border="0">
723
- <col align="left" valign="top">
724
- <tbody><tr>
725
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
726
- <td>a newly-allocated <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>
727
- </td>
728
- </tr></tbody>
729
- </table></div>
730
- </div>
731
- <hr>
732
- <div class="refsect2">
733
- <a name="g-date-new-dmy"></a><h3>g_date_new_dmy ()</h3>
734
- <pre class="programlisting"><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="returnvalue">GDate</span></a> * g_date_new_dmy (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDateDay" title="GDateDay"><span class="type">GDateDay</span></a> day</code></em>,
735
- <em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth" title="enum GDateMonth"><span class="type">GDateMonth</span></a> month</code></em>,
736
- <em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear"><span class="type">GDateYear</span></a> year</code></em>);</pre>
737
- <p>
738
- Like <a class="link" href="glib-Date-and-Time-Functions.html#g-date-new" title="g_date_new ()"><code class="function">g_date_new()</code></a>, but also sets the value of the date. Assuming the
739
- day-month-year triplet you pass in represents an existing day, the
740
- returned date will be valid.
741
- </p>
742
- <div class="variablelist"><table border="0">
743
- <col align="left" valign="top">
744
- <tbody>
745
- <tr>
746
- <td><p><span class="term"><em class="parameter"><code>day</code></em> :</span></p></td>
747
- <td>day of the month
748
- </td>
749
- </tr>
750
- <tr>
751
- <td><p><span class="term"><em class="parameter"><code>month</code></em> :</span></p></td>
752
- <td>month of the year
753
- </td>
754
- </tr>
755
- <tr>
756
- <td><p><span class="term"><em class="parameter"><code>year</code></em> :</span></p></td>
757
- <td>year
758
- </td>
759
- </tr>
760
- <tr>
761
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
762
- <td>a newly-allocated <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> initialized with <em class="parameter"><code>day</code></em>, <em class="parameter"><code>month</code></em>, and <em class="parameter"><code>year</code></em>
763
- </td>
764
- </tr>
765
- </tbody>
766
- </table></div>
767
- </div>
768
- <hr>
769
- <div class="refsect2">
770
- <a name="g-date-new-julian"></a><h3>g_date_new_julian ()</h3>
771
- <pre class="programlisting"><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="returnvalue">GDate</span></a> * g_date_new_julian (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint32" title="guint32"><span class="type">guint32</span></a> julian_day</code></em>);</pre>
772
- <p>
773
- Like <a class="link" href="glib-Date-and-Time-Functions.html#g-date-new" title="g_date_new ()"><code class="function">g_date_new()</code></a>, but also sets the value of the date. Assuming the
774
- Julian day number you pass in is valid (greater than 0, less than an
775
- unreasonably large number), the returned date will be valid.
776
- </p>
777
- <div class="variablelist"><table border="0">
778
- <col align="left" valign="top">
779
- <tbody>
780
- <tr>
781
- <td><p><span class="term"><em class="parameter"><code>julian_day</code></em> :</span></p></td>
782
- <td>days since January 1, Year 1
783
- </td>
784
- </tr>
785
- <tr>
786
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
787
- <td>a newly-allocated <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> initialized with <em class="parameter"><code>julian_day</code></em>
788
- </td>
789
- </tr>
790
- </tbody>
791
- </table></div>
792
- </div>
793
- <hr>
794
- <div class="refsect2">
795
- <a name="g-date-clear"></a><h3>g_date_clear ()</h3>
796
- <pre class="programlisting"><span class="returnvalue">void</span> g_date_clear (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>,
797
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="type">guint</span></a> n_dates</code></em>);</pre>
798
- <p>
799
- Initializes one or more <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> structs to a sane but invalid
800
- state. The cleared dates will not represent an existing date, but will
801
- not contain garbage. Useful to init a date declared on the stack.
802
- Validity can be tested with <a class="link" href="glib-Date-and-Time-Functions.html#g-date-valid" title="g_date_valid ()"><code class="function">g_date_valid()</code></a>.
803
- </p>
804
- <div class="variablelist"><table border="0">
805
- <col align="left" valign="top">
806
- <tbody>
807
- <tr>
808
- <td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
809
- <td>pointer to one or more dates to clear
810
- </td>
811
- </tr>
812
- <tr>
813
- <td><p><span class="term"><em class="parameter"><code>n_dates</code></em> :</span></p></td>
814
- <td>number of dates to clear
815
- </td>
816
- </tr>
817
- </tbody>
818
- </table></div>
819
- </div>
820
- <hr>
821
- <div class="refsect2">
822
- <a name="g-date-free"></a><h3>g_date_free ()</h3>
823
- <pre class="programlisting"><span class="returnvalue">void</span> g_date_free (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>);</pre>
824
- <p>
825
- Frees a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> returned from <a class="link" href="glib-Date-and-Time-Functions.html#g-date-new" title="g_date_new ()"><code class="function">g_date_new()</code></a>.
826
- </p>
827
- <div class="variablelist"><table border="0">
828
- <col align="left" valign="top">
829
- <tbody><tr>
830
- <td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
831
- <td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>
832
- </td>
833
- </tr></tbody>
834
- </table></div>
835
- </div>
836
- <hr>
837
- <div class="refsect2">
838
- <a name="g-date-set-day"></a><h3>g_date_set_day ()</h3>
839
- <pre class="programlisting"><span class="returnvalue">void</span> g_date_set_day (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>,
840
- <em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDateDay" title="GDateDay"><span class="type">GDateDay</span></a> day</code></em>);</pre>
841
- <p>
842
- Sets the day of the month for a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>. If the resulting day-month-year
843
- triplet is invalid, the date will be invalid.
844
- </p>
845
- <div class="variablelist"><table border="0">
846
- <col align="left" valign="top">
847
- <tbody>
848
- <tr>
849
- <td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
850
- <td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>
851
- </td>
852
- </tr>
853
- <tr>
854
- <td><p><span class="term"><em class="parameter"><code>day</code></em> :</span></p></td>
855
- <td>day to set
856
- </td>
857
- </tr>
858
- </tbody>
859
- </table></div>
860
- </div>
861
- <hr>
862
- <div class="refsect2">
863
- <a name="g-date-set-month"></a><h3>g_date_set_month ()</h3>
864
- <pre class="programlisting"><span class="returnvalue">void</span> g_date_set_month (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>,
865
- <em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth" title="enum GDateMonth"><span class="type">GDateMonth</span></a> month</code></em>);</pre>
866
- <p>
867
- Sets the month of the year for a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>. If the resulting
868
- day-month-year triplet is invalid, the date will be invalid.
869
- </p>
870
- <div class="variablelist"><table border="0">
871
- <col align="left" valign="top">
872
- <tbody>
873
- <tr>
874
- <td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
875
- <td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>
876
- </td>
877
- </tr>
878
- <tr>
879
- <td><p><span class="term"><em class="parameter"><code>month</code></em> :</span></p></td>
880
- <td>month to set
881
- </td>
882
- </tr>
883
- </tbody>
884
- </table></div>
885
- </div>
886
- <hr>
887
- <div class="refsect2">
888
- <a name="g-date-set-year"></a><h3>g_date_set_year ()</h3>
889
- <pre class="programlisting"><span class="returnvalue">void</span> g_date_set_year (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>,
890
- <em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear"><span class="type">GDateYear</span></a> year</code></em>);</pre>
891
- <p>
892
- Sets the year for a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>. If the resulting day-month-year triplet is
893
- invalid, the date will be invalid.
894
- </p>
895
- <div class="variablelist"><table border="0">
896
- <col align="left" valign="top">
897
- <tbody>
898
- <tr>
899
- <td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
900
- <td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>
901
- </td>
902
- </tr>
903
- <tr>
904
- <td><p><span class="term"><em class="parameter"><code>year</code></em> :</span></p></td>
905
- <td>year to set
906
- </td>
907
- </tr>
908
- </tbody>
909
- </table></div>
910
- </div>
911
- <hr>
912
- <div class="refsect2">
913
- <a name="g-date-set-dmy"></a><h3>g_date_set_dmy ()</h3>
914
- <pre class="programlisting"><span class="returnvalue">void</span> g_date_set_dmy (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>,
915
- <em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDateDay" title="GDateDay"><span class="type">GDateDay</span></a> day</code></em>,
916
- <em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth" title="enum GDateMonth"><span class="type">GDateMonth</span></a> month</code></em>,
917
- <em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear"><span class="type">GDateYear</span></a> y</code></em>);</pre>
918
- <p>
919
- Sets the value of a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> from a day, month, and year. The day-month-year
920
- triplet must be valid; if you aren't sure it is, call <a class="link" href="glib-Date-and-Time-Functions.html#g-date-valid-dmy" title="g_date_valid_dmy ()"><code class="function">g_date_valid_dmy()</code></a> to
921
- check before you set it.
922
- </p>
923
- <div class="variablelist"><table border="0">
924
- <col align="left" valign="top">
925
- <tbody>
926
- <tr>
927
- <td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
928
- <td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>
929
- </td>
930
- </tr>
931
- <tr>
932
- <td><p><span class="term"><em class="parameter"><code>day</code></em> :</span></p></td>
933
- <td>day
934
- </td>
935
- </tr>
936
- <tr>
937
- <td><p><span class="term"><em class="parameter"><code>month</code></em> :</span></p></td>
938
- <td>month
939
- </td>
940
- </tr>
941
- <tr>
942
- <td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
943
- <td>year
944
- </td>
945
- </tr>
946
- </tbody>
947
- </table></div>
948
- </div>
949
- <hr>
950
- <div class="refsect2">
951
- <a name="g-date-set-julian"></a><h3>g_date_set_julian ()</h3>
952
- <pre class="programlisting"><span class="returnvalue">void</span> g_date_set_julian (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>,
953
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint32" title="guint32"><span class="type">guint32</span></a> julian_date</code></em>);</pre>
954
- <p>
955
- Sets the value of a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> from a Julian day number.
956
- </p>
957
- <div class="variablelist"><table border="0">
958
- <col align="left" valign="top">
959
- <tbody>
960
- <tr>
961
- <td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
962
- <td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>
963
- </td>
964
- </tr>
965
- <tr>
966
- <td><p><span class="term"><em class="parameter"><code>julian_date</code></em> :</span></p></td>
967
- <td>Julian day number (days since January 1, Year 1)
968
- </td>
969
- </tr>
970
- </tbody>
971
- </table></div>
972
- </div>
973
- <hr>
974
- <div class="refsect2">
975
- <a name="g-date-set-time"></a><h3>g_date_set_time ()</h3>
976
- <pre class="programlisting"><span class="returnvalue">void</span> g_date_set_time (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>,
977
- <em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GTime" title="GTime"><span class="type">GTime</span></a> time_</code></em>);</pre>
978
- <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
979
- <h3 class="title">Warning</h3>
980
- <p><code class="literal">g_date_set_time</code> has been deprecated since version 2.10 and should not be used in newly-written code. Use <a class="link" href="glib-Date-and-Time-Functions.html#g-date-set-time-t" title="g_date_set_time_t ()"><code class="function">g_date_set_time_t()</code></a> instead.</p>
981
- </div>
982
- <p>
983
- Sets the value of a date from a <a class="link" href="glib-Date-and-Time-Functions.html#GTime" title="GTime"><span class="type">GTime</span></a> value.
984
- The time to date conversion is done using the user's current timezone.
985
- </p>
986
- <div class="variablelist"><table border="0">
987
- <col align="left" valign="top">
988
- <tbody>
989
- <tr>
990
- <td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
991
- <td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>.
992
- </td>
993
- </tr>
994
- <tr>
995
- <td><p><span class="term"><em class="parameter"><code>time_</code></em> :</span></p></td>
996
- <td>
997
- <a class="link" href="glib-Date-and-Time-Functions.html#GTime" title="GTime"><span class="type">GTime</span></a> value to set.
998
- </td>
999
- </tr>
1000
- </tbody>
1001
- </table></div>
1002
- </div>
1003
- <hr>
1004
- <div class="refsect2">
1005
- <a name="g-date-set-time-t"></a><h3>g_date_set_time_t ()</h3>
1006
- <pre class="programlisting"><span class="returnvalue">void</span> g_date_set_time_t (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>,
1007
- <em class="parameter"><code><span class="type">time_t</span> timet</code></em>);</pre>
1008
- <p>
1009
- Sets the value of a date to the date corresponding to a time
1010
- specified as a time_t. The time to date conversion is done using
1011
- the user's current timezone.
1012
- </p>
1013
- <p>
1014
- To set the value of a date to the current day, you could write:
1015
- </p>
1016
- <div class="informalexample">
1017
- <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
1018
- <tbody>
1019
- <tr>
1020
- <td class="listing_lines" align="right"><pre>1</pre></td>
1021
- <td class="listing_code"><pre class="programlisting"><span class="function"><a href="glib-Date-and-Time-Functions.html#g-date-set-time-t">g_date_set_time_t</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">date</span><span class="symbol">,</span><span class="normal"> </span><span class="function">time</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">));</span></pre></td>
1022
- </tr>
1023
- </tbody>
1024
- </table>
1025
- </div>
1026
-
1027
- <p>
1028
- </p>
1029
- <div class="variablelist"><table border="0">
1030
- <col align="left" valign="top">
1031
- <tbody>
1032
- <tr>
1033
- <td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
1034
- <td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>
1035
- </td>
1036
- </tr>
1037
- <tr>
1038
- <td><p><span class="term"><em class="parameter"><code>timet</code></em> :</span></p></td>
1039
- <td>
1040
- <span class="type">time_t</span> value to set
1041
- </td>
1042
- </tr>
1043
- </tbody>
1044
- </table></div>
1045
- <p class="since">Since 2.10</p>
1046
- </div>
1047
- <hr>
1048
- <div class="refsect2">
1049
- <a name="g-date-set-time-val"></a><h3>g_date_set_time_val ()</h3>
1050
- <pre class="programlisting"><span class="returnvalue">void</span> g_date_set_time_val (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>,
1051
- <em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal"><span class="type">GTimeVal</span></a> *timeval</code></em>);</pre>
1052
- <p>
1053
- Sets the value of a date from a <a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal"><span class="type">GTimeVal</span></a> value. Note that the
1054
- <em class="parameter"><code>tv_usec</code></em> member is ignored, because <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> can't make use of the
1055
- additional precision.
1056
- </p>
1057
- <p>
1058
- The time to date conversion is done using the user's current timezone.
1059
- </p>
1060
- <div class="variablelist"><table border="0">
1061
- <col align="left" valign="top">
1062
- <tbody>
1063
- <tr>
1064
- <td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
1065
- <td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>
1066
- </td>
1067
- </tr>
1068
- <tr>
1069
- <td><p><span class="term"><em class="parameter"><code>timeval</code></em> :</span></p></td>
1070
- <td>
1071
- <a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal"><span class="type">GTimeVal</span></a> value to set
1072
- </td>
1073
- </tr>
1074
- </tbody>
1075
- </table></div>
1076
- <p class="since">Since 2.10</p>
1077
- </div>
1078
- <hr>
1079
- <div class="refsect2">
1080
- <a name="g-date-set-parse"></a><h3>g_date_set_parse ()</h3>
1081
- <pre class="programlisting"><span class="returnvalue">void</span> g_date_set_parse (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>,
1082
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>);</pre>
1083
- <p>
1084
- Parses a user-inputted string <em class="parameter"><code>str</code></em>, and try to figure out what date it
1085
- represents, taking the <a class="link" href="glib-running.html#setlocale" title="Locale">current locale</a>
1086
- into account. If the string is successfully parsed, the date will be
1087
- valid after the call. Otherwise, it will be invalid. You should check
1088
- using <a class="link" href="glib-Date-and-Time-Functions.html#g-date-valid" title="g_date_valid ()"><code class="function">g_date_valid()</code></a> to see whether the parsing succeeded.
1089
- </p>
1090
- <p>
1091
- This function is not appropriate for file formats and the like; it
1092
- isn't very precise, and its exact behavior varies with the
1093
- locale. It's intended to be a heuristic routine that guesses what the
1094
- user means by a given string (and it does work pretty well in that
1095
- capacity).
1096
- </p>
1097
- <div class="variablelist"><table border="0">
1098
- <col align="left" valign="top">
1099
- <tbody>
1100
- <tr>
1101
- <td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
1102
- <td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> to fill in
1103
- </td>
1104
- </tr>
1105
- <tr>
1106
- <td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
1107
- <td>string to parse
1108
- </td>
1109
- </tr>
1110
- </tbody>
1111
- </table></div>
1112
- </div>
1113
- <hr>
1114
- <div class="refsect2">
1115
- <a name="g-date-add-days"></a><h3>g_date_add_days ()</h3>
1116
- <pre class="programlisting"><span class="returnvalue">void</span> g_date_add_days (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>,
1117
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="type">guint</span></a> n_days</code></em>);</pre>
1118
- <p>
1119
- Increments a date some number of days. To move forward by weeks, add
1120
- weeks*7 days. The date must be valid.
1121
- </p>
1122
- <div class="variablelist"><table border="0">
1123
- <col align="left" valign="top">
1124
- <tbody>
1125
- <tr>
1126
- <td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
1127
- <td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> to increment
1128
- </td>
1129
- </tr>
1130
- <tr>
1131
- <td><p><span class="term"><em class="parameter"><code>n_days</code></em> :</span></p></td>
1132
- <td>number of days to move the date forward
1133
- </td>
1134
- </tr>
1135
- </tbody>
1136
- </table></div>
1137
- </div>
1138
- <hr>
1139
- <div class="refsect2">
1140
- <a name="g-date-subtract-days"></a><h3>g_date_subtract_days ()</h3>
1141
- <pre class="programlisting"><span class="returnvalue">void</span> g_date_subtract_days (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>,
1142
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="type">guint</span></a> n_days</code></em>);</pre>
1143
- <p>
1144
- Moves a date some number of days into the past. To move by weeks, just
1145
- move by weeks*7 days. The date must be valid.
1146
- </p>
1147
- <div class="variablelist"><table border="0">
1148
- <col align="left" valign="top">
1149
- <tbody>
1150
- <tr>
1151
- <td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
1152
- <td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> to decrement
1153
- </td>
1154
- </tr>
1155
- <tr>
1156
- <td><p><span class="term"><em class="parameter"><code>n_days</code></em> :</span></p></td>
1157
- <td>number of days to move
1158
- </td>
1159
- </tr>
1160
- </tbody>
1161
- </table></div>
1162
- </div>
1163
- <hr>
1164
- <div class="refsect2">
1165
- <a name="g-date-add-months"></a><h3>g_date_add_months ()</h3>
1166
- <pre class="programlisting"><span class="returnvalue">void</span> g_date_add_months (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>,
1167
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="type">guint</span></a> n_months</code></em>);</pre>
1168
- <p>
1169
- Increments a date by some number of months. If the day of the month is
1170
- greater than 28, this routine may change the day of the month (because
1171
- the destination month may not have the current day in it). The date
1172
- must be valid.
1173
- </p>
1174
- <div class="variablelist"><table border="0">
1175
- <col align="left" valign="top">
1176
- <tbody>
1177
- <tr>
1178
- <td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
1179
- <td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> to increment
1180
- </td>
1181
- </tr>
1182
- <tr>
1183
- <td><p><span class="term"><em class="parameter"><code>n_months</code></em> :</span></p></td>
1184
- <td>number of months to move forward
1185
- </td>
1186
- </tr>
1187
- </tbody>
1188
- </table></div>
1189
- </div>
1190
- <hr>
1191
- <div class="refsect2">
1192
- <a name="g-date-subtract-months"></a><h3>g_date_subtract_months ()</h3>
1193
- <pre class="programlisting"><span class="returnvalue">void</span> g_date_subtract_months (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>,
1194
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="type">guint</span></a> n_months</code></em>);</pre>
1195
- <p>
1196
- Moves a date some number of months into the past. If the current day of
1197
- the month doesn't exist in the destination month, the day of the month
1198
- may change. The date must be valid.
1199
- </p>
1200
- <div class="variablelist"><table border="0">
1201
- <col align="left" valign="top">
1202
- <tbody>
1203
- <tr>
1204
- <td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
1205
- <td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> to decrement
1206
- </td>
1207
- </tr>
1208
- <tr>
1209
- <td><p><span class="term"><em class="parameter"><code>n_months</code></em> :</span></p></td>
1210
- <td>number of months to move
1211
- </td>
1212
- </tr>
1213
- </tbody>
1214
- </table></div>
1215
- </div>
1216
- <hr>
1217
- <div class="refsect2">
1218
- <a name="g-date-add-years"></a><h3>g_date_add_years ()</h3>
1219
- <pre class="programlisting"><span class="returnvalue">void</span> g_date_add_years (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>,
1220
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="type">guint</span></a> n_years</code></em>);</pre>
1221
- <p>
1222
- Increments a date by some number of years. If the date is February 29,
1223
- and the destination year is not a leap year, the date will be changed
1224
- to February 28. The date must be valid.
1225
- </p>
1226
- <div class="variablelist"><table border="0">
1227
- <col align="left" valign="top">
1228
- <tbody>
1229
- <tr>
1230
- <td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
1231
- <td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> to increment
1232
- </td>
1233
- </tr>
1234
- <tr>
1235
- <td><p><span class="term"><em class="parameter"><code>n_years</code></em> :</span></p></td>
1236
- <td>number of years to move forward
1237
- </td>
1238
- </tr>
1239
- </tbody>
1240
- </table></div>
1241
- </div>
1242
- <hr>
1243
- <div class="refsect2">
1244
- <a name="g-date-subtract-years"></a><h3>g_date_subtract_years ()</h3>
1245
- <pre class="programlisting"><span class="returnvalue">void</span> g_date_subtract_years (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>,
1246
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="type">guint</span></a> n_years</code></em>);</pre>
1247
- <p>
1248
- Moves a date some number of years into the past. If the current day
1249
- doesn't exist in the destination year (i.e. it's February 29 and you
1250
- move to a non-leap-year) then the day is changed to February 29. The date
1251
- must be valid.
1252
- </p>
1253
- <div class="variablelist"><table border="0">
1254
- <col align="left" valign="top">
1255
- <tbody>
1256
- <tr>
1257
- <td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
1258
- <td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> to decrement
1259
- </td>
1260
- </tr>
1261
- <tr>
1262
- <td><p><span class="term"><em class="parameter"><code>n_years</code></em> :</span></p></td>
1263
- <td>number of years to move
1264
- </td>
1265
- </tr>
1266
- </tbody>
1267
- </table></div>
1268
- </div>
1269
- <hr>
1270
- <div class="refsect2">
1271
- <a name="g-date-days-between"></a><h3>g_date_days_between ()</h3>
1272
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> g_date_days_between (<em class="parameter"><code>const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date1</code></em>,
1273
- <em class="parameter"><code>const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date2</code></em>);</pre>
1274
- <p>
1275
- Computes the number of days between two dates.
1276
- If <em class="parameter"><code>date2</code></em> is prior to <em class="parameter"><code>date1</code></em>, the returned value is negative.
1277
- Both dates must be valid.
1278
- </p>
1279
- <div class="variablelist"><table border="0">
1280
- <col align="left" valign="top">
1281
- <tbody>
1282
- <tr>
1283
- <td><p><span class="term"><em class="parameter"><code>date1</code></em> :</span></p></td>
1284
- <td>the first date
1285
- </td>
1286
- </tr>
1287
- <tr>
1288
- <td><p><span class="term"><em class="parameter"><code>date2</code></em> :</span></p></td>
1289
- <td>the second date
1290
- </td>
1291
- </tr>
1292
- <tr>
1293
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1294
- <td>the number of days between <em class="parameter"><code>date1</code></em> and <em class="parameter"><code>date2</code></em>
1295
- </td>
1296
- </tr>
1297
- </tbody>
1298
- </table></div>
1299
- </div>
1300
- <hr>
1301
- <div class="refsect2">
1302
- <a name="g-date-compare"></a><h3>g_date_compare ()</h3>
1303
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> g_date_compare (<em class="parameter"><code>const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *lhs</code></em>,
1304
- <em class="parameter"><code>const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *rhs</code></em>);</pre>
1305
- <p>
1306
- <code class="function">qsort()</code>-style comparsion function for dates. Both
1307
- dates must be valid.
1308
- </p>
1309
- <div class="variablelist"><table border="0">
1310
- <col align="left" valign="top">
1311
- <tbody>
1312
- <tr>
1313
- <td><p><span class="term"><em class="parameter"><code>lhs</code></em> :</span></p></td>
1314
- <td>first date to compare
1315
- </td>
1316
- </tr>
1317
- <tr>
1318
- <td><p><span class="term"><em class="parameter"><code>rhs</code></em> :</span></p></td>
1319
- <td>second date to compare
1320
- </td>
1321
- </tr>
1322
- <tr>
1323
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1324
- <td>0 for equal, less than zero if <em class="parameter"><code>lhs</code></em> is less than <em class="parameter"><code>rhs</code></em>,
1325
- greater than zero if <em class="parameter"><code>lhs</code></em> is greater than <em class="parameter"><code>rhs</code></em>
1326
- </td>
1327
- </tr>
1328
- </tbody>
1329
- </table></div>
1330
- </div>
1331
- <hr>
1332
- <div class="refsect2">
1333
- <a name="g-date-clamp"></a><h3>g_date_clamp ()</h3>
1334
- <pre class="programlisting"><span class="returnvalue">void</span> g_date_clamp (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>,
1335
- <em class="parameter"><code>const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *min_date</code></em>,
1336
- <em class="parameter"><code>const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *max_date</code></em>);</pre>
1337
- <p>
1338
- If <em class="parameter"><code>date</code></em> is prior to <em class="parameter"><code>min_date</code></em>, sets <em class="parameter"><code>date</code></em> equal to <em class="parameter"><code>min_date</code></em>.
1339
- If <em class="parameter"><code>date</code></em> falls after <em class="parameter"><code>max_date</code></em>, sets <em class="parameter"><code>date</code></em> equal to <em class="parameter"><code>max_date</code></em>.
1340
- Otherwise, <em class="parameter"><code>date</code></em> is unchanged.
1341
- Either of <em class="parameter"><code>min_date</code></em> and <em class="parameter"><code>max_date</code></em> may be <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. All non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> dates
1342
- must be valid.
1343
- </p>
1344
- <div class="variablelist"><table border="0">
1345
- <col align="left" valign="top">
1346
- <tbody>
1347
- <tr>
1348
- <td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
1349
- <td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> to clamp
1350
- </td>
1351
- </tr>
1352
- <tr>
1353
- <td><p><span class="term"><em class="parameter"><code>min_date</code></em> :</span></p></td>
1354
- <td>minimum accepted value for <em class="parameter"><code>date</code></em>
1355
- </td>
1356
- </tr>
1357
- <tr>
1358
- <td><p><span class="term"><em class="parameter"><code>max_date</code></em> :</span></p></td>
1359
- <td>maximum accepted value for <em class="parameter"><code>date</code></em>
1360
- </td>
1361
- </tr>
1362
- </tbody>
1363
- </table></div>
1364
- </div>
1365
- <hr>
1366
- <div class="refsect2">
1367
- <a name="g-date-order"></a><h3>g_date_order ()</h3>
1368
- <pre class="programlisting"><span class="returnvalue">void</span> g_date_order (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date1</code></em>,
1369
- <em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date2</code></em>);</pre>
1370
- <p>
1371
- Checks if <em class="parameter"><code>date1</code></em> is less than or equal to <em class="parameter"><code>date2</code></em>,
1372
- and swap the values if this is not the case.
1373
- </p>
1374
- <div class="variablelist"><table border="0">
1375
- <col align="left" valign="top">
1376
- <tbody>
1377
- <tr>
1378
- <td><p><span class="term"><em class="parameter"><code>date1</code></em> :</span></p></td>
1379
- <td>the first date
1380
- </td>
1381
- </tr>
1382
- <tr>
1383
- <td><p><span class="term"><em class="parameter"><code>date2</code></em> :</span></p></td>
1384
- <td>the second date
1385
- </td>
1386
- </tr>
1387
- </tbody>
1388
- </table></div>
1389
- </div>
1390
- <hr>
1391
- <div class="refsect2">
1392
- <a name="g-date-get-day"></a><h3>g_date_get_day ()</h3>
1393
- <pre class="programlisting"><a class="link" href="glib-Date-and-Time-Functions.html#GDateDay" title="GDateDay"><span class="returnvalue">GDateDay</span></a> g_date_get_day (<em class="parameter"><code>const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>);</pre>
1394
- <p>
1395
- Returns the day of the month. The date must be valid.
1396
- </p>
1397
- <div class="variablelist"><table border="0">
1398
- <col align="left" valign="top">
1399
- <tbody>
1400
- <tr>
1401
- <td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
1402
- <td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> to extract the day of the month from
1403
- </td>
1404
- </tr>
1405
- <tr>
1406
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1407
- <td>day of the month
1408
- </td>
1409
- </tr>
1410
- </tbody>
1411
- </table></div>
1412
- </div>
1413
- <hr>
1414
- <div class="refsect2">
1415
- <a name="g-date-get-month"></a><h3>g_date_get_month ()</h3>
1416
- <pre class="programlisting"><a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth" title="enum GDateMonth"><span class="returnvalue">GDateMonth</span></a> g_date_get_month (<em class="parameter"><code>const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>);</pre>
1417
- <p>
1418
- Returns the month of the year. The date must be valid.
1419
- </p>
1420
- <div class="variablelist"><table border="0">
1421
- <col align="left" valign="top">
1422
- <tbody>
1423
- <tr>
1424
- <td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
1425
- <td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> to get the month from
1426
- </td>
1427
- </tr>
1428
- <tr>
1429
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1430
- <td>month of the year as a <a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth" title="enum GDateMonth"><span class="type">GDateMonth</span></a>
1431
- </td>
1432
- </tr>
1433
- </tbody>
1434
- </table></div>
1435
- </div>
1436
- <hr>
1437
- <div class="refsect2">
1438
- <a name="g-date-get-year"></a><h3>g_date_get_year ()</h3>
1439
- <pre class="programlisting"><a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear"><span class="returnvalue">GDateYear</span></a> g_date_get_year (<em class="parameter"><code>const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>);</pre>
1440
- <p>
1441
- Returns the year of a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>. The date must be valid.
1442
- </p>
1443
- <div class="variablelist"><table border="0">
1444
- <col align="left" valign="top">
1445
- <tbody>
1446
- <tr>
1447
- <td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
1448
- <td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>
1449
- </td>
1450
- </tr>
1451
- <tr>
1452
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1453
- <td>year in which the date falls
1454
- </td>
1455
- </tr>
1456
- </tbody>
1457
- </table></div>
1458
- </div>
1459
- <hr>
1460
- <div class="refsect2">
1461
- <a name="g-date-get-julian"></a><h3>g_date_get_julian ()</h3>
1462
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint32" title="guint32"><span class="returnvalue">guint32</span></a> g_date_get_julian (<em class="parameter"><code>const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>);</pre>
1463
- <p>
1464
- Returns the Julian day or "serial number" of the <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>. The
1465
- Julian day is simply the number of days since January 1, Year 1; i.e.,
1466
- January 1, Year 1 is Julian day 1; January 2, Year 1 is Julian day 2,
1467
- etc. The date must be valid.
1468
- </p>
1469
- <div class="variablelist"><table border="0">
1470
- <col align="left" valign="top">
1471
- <tbody>
1472
- <tr>
1473
- <td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
1474
- <td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> to extract the Julian day from
1475
- </td>
1476
- </tr>
1477
- <tr>
1478
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1479
- <td>Julian day
1480
- </td>
1481
- </tr>
1482
- </tbody>
1483
- </table></div>
1484
- </div>
1485
- <hr>
1486
- <div class="refsect2">
1487
- <a name="g-date-get-weekday"></a><h3>g_date_get_weekday ()</h3>
1488
- <pre class="programlisting"><a class="link" href="glib-Date-and-Time-Functions.html#GDateWeekday" title="enum GDateWeekday"><span class="returnvalue">GDateWeekday</span></a> g_date_get_weekday (<em class="parameter"><code>const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>);</pre>
1489
- <p>
1490
- Returns the day of the week for a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>. The date must be valid.
1491
- </p>
1492
- <div class="variablelist"><table border="0">
1493
- <col align="left" valign="top">
1494
- <tbody>
1495
- <tr>
1496
- <td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
1497
- <td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>.
1498
- </td>
1499
- </tr>
1500
- <tr>
1501
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1502
- <td>day of the week as a <a class="link" href="glib-Date-and-Time-Functions.html#GDateWeekday" title="enum GDateWeekday"><span class="type">GDateWeekday</span></a>.
1503
- </td>
1504
- </tr>
1505
- </tbody>
1506
- </table></div>
1507
- </div>
1508
- <hr>
1509
- <div class="refsect2">
1510
- <a name="g-date-get-day-of-year"></a><h3>g_date_get_day_of_year ()</h3>
1511
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="returnvalue">guint</span></a> g_date_get_day_of_year (<em class="parameter"><code>const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>);</pre>
1512
- <p>
1513
- Returns the day of the year, where Jan 1 is the first day of the
1514
- year. The date must be valid.
1515
- </p>
1516
- <div class="variablelist"><table border="0">
1517
- <col align="left" valign="top">
1518
- <tbody>
1519
- <tr>
1520
- <td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
1521
- <td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> to extract day of year from
1522
- </td>
1523
- </tr>
1524
- <tr>
1525
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1526
- <td>day of the year
1527
- </td>
1528
- </tr>
1529
- </tbody>
1530
- </table></div>
1531
- </div>
1532
- <hr>
1533
- <div class="refsect2">
1534
- <a name="g-date-get-days-in-month"></a><h3>g_date_get_days_in_month ()</h3>
1535
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint8" title="guint8"><span class="returnvalue">guint8</span></a> g_date_get_days_in_month (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth" title="enum GDateMonth"><span class="type">GDateMonth</span></a> month</code></em>,
1536
- <em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear"><span class="type">GDateYear</span></a> year</code></em>);</pre>
1537
- <p>
1538
- Returns the number of days in a month, taking leap years into account.
1539
- </p>
1540
- <div class="variablelist"><table border="0">
1541
- <col align="left" valign="top">
1542
- <tbody>
1543
- <tr>
1544
- <td><p><span class="term"><em class="parameter"><code>month</code></em> :</span></p></td>
1545
- <td>month
1546
- </td>
1547
- </tr>
1548
- <tr>
1549
- <td><p><span class="term"><em class="parameter"><code>year</code></em> :</span></p></td>
1550
- <td>year
1551
- </td>
1552
- </tr>
1553
- <tr>
1554
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1555
- <td>number of days in <em class="parameter"><code>month</code></em> during the <em class="parameter"><code>year</code></em>
1556
- </td>
1557
- </tr>
1558
- </tbody>
1559
- </table></div>
1560
- </div>
1561
- <hr>
1562
- <div class="refsect2">
1563
- <a name="g-date-is-first-of-month"></a><h3>g_date_is_first_of_month ()</h3>
1564
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_date_is_first_of_month (<em class="parameter"><code>const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>);</pre>
1565
- <p>
1566
- Returns <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the date is on the first of a month. The date must be valid.
1567
- </p>
1568
- <div class="variablelist"><table border="0">
1569
- <col align="left" valign="top">
1570
- <tbody>
1571
- <tr>
1572
- <td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
1573
- <td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> to check
1574
- </td>
1575
- </tr>
1576
- <tr>
1577
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1578
- <td>
1579
- <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the date is the first of the month
1580
- </td>
1581
- </tr>
1582
- </tbody>
1583
- </table></div>
1584
- </div>
1585
- <hr>
1586
- <div class="refsect2">
1587
- <a name="g-date-is-last-of-month"></a><h3>g_date_is_last_of_month ()</h3>
1588
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_date_is_last_of_month (<em class="parameter"><code>const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>);</pre>
1589
- <p>
1590
- Returns <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the date is the last day of the month. The date must be valid.
1591
- </p>
1592
- <div class="variablelist"><table border="0">
1593
- <col align="left" valign="top">
1594
- <tbody>
1595
- <tr>
1596
- <td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
1597
- <td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> to check
1598
- </td>
1599
- </tr>
1600
- <tr>
1601
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1602
- <td>
1603
- <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the date is the last day of the month
1604
- </td>
1605
- </tr>
1606
- </tbody>
1607
- </table></div>
1608
- </div>
1609
- <hr>
1610
- <div class="refsect2">
1611
- <a name="g-date-is-leap-year"></a><h3>g_date_is_leap_year ()</h3>
1612
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_date_is_leap_year (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear"><span class="type">GDateYear</span></a> year</code></em>);</pre>
1613
- <p>
1614
- Returns <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the year is a leap year.<sup>[<a name="id723118" href="#ftn.id723118" class="footnote">4</a>]</sup>
1615
- </p>
1616
- <div class="variablelist"><table border="0">
1617
- <col align="left" valign="top">
1618
- <tbody>
1619
- <tr>
1620
- <td><p><span class="term"><em class="parameter"><code>year</code></em> :</span></p></td>
1621
- <td>year to check
1622
- </td>
1623
- </tr>
1624
- <tr>
1625
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1626
- <td>
1627
- <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the year is a leap year
1628
- </td>
1629
- </tr>
1630
- </tbody>
1631
- </table></div>
1632
- </div>
1633
- <hr>
1634
- <div class="refsect2">
1635
- <a name="g-date-get-monday-week-of-year"></a><h3>g_date_get_monday_week_of_year ()</h3>
1636
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="returnvalue">guint</span></a> g_date_get_monday_week_of_year (<em class="parameter"><code>const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>);</pre>
1637
- <p>
1638
- Returns the week of the year, where weeks are understood to start on
1639
- Monday. If the date is before the first Monday of the year, return
1640
- 0. The date must be valid.
1641
- </p>
1642
- <div class="variablelist"><table border="0">
1643
- <col align="left" valign="top">
1644
- <tbody>
1645
- <tr>
1646
- <td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
1647
- <td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>
1648
- </td>
1649
- </tr>
1650
- <tr>
1651
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1652
- <td>week of the year
1653
- </td>
1654
- </tr>
1655
- </tbody>
1656
- </table></div>
1657
- </div>
1658
- <hr>
1659
- <div class="refsect2">
1660
- <a name="g-date-get-monday-weeks-in-year"></a><h3>g_date_get_monday_weeks_in_year ()</h3>
1661
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint8" title="guint8"><span class="returnvalue">guint8</span></a> g_date_get_monday_weeks_in_year (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear"><span class="type">GDateYear</span></a> year</code></em>);</pre>
1662
- <p>
1663
- Returns the number of weeks in the year, where weeks are taken to start
1664
- on Monday. Will be 52 or 53. The date must be valid. (Years always have 52
1665
- 7-day periods, plus 1 or 2 extra days depending on whether it's a leap
1666
- year. This function is basically telling you how many Mondays are in
1667
- the year, i.e. there are 53 Mondays if one of the extra days happens
1668
- to be a Monday.)
1669
- </p>
1670
- <div class="variablelist"><table border="0">
1671
- <col align="left" valign="top">
1672
- <tbody>
1673
- <tr>
1674
- <td><p><span class="term"><em class="parameter"><code>year</code></em> :</span></p></td>
1675
- <td>a year
1676
- </td>
1677
- </tr>
1678
- <tr>
1679
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1680
- <td>number of Mondays in the year
1681
- </td>
1682
- </tr>
1683
- </tbody>
1684
- </table></div>
1685
- </div>
1686
- <hr>
1687
- <div class="refsect2">
1688
- <a name="g-date-get-sunday-week-of-year"></a><h3>g_date_get_sunday_week_of_year ()</h3>
1689
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="returnvalue">guint</span></a> g_date_get_sunday_week_of_year (<em class="parameter"><code>const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>);</pre>
1690
- <p>
1691
- Returns the week of the year during which this date falls, if weeks
1692
- are understood to being on Sunday. The date must be valid. Can return 0 if
1693
- the day is before the first Sunday of the year.
1694
- </p>
1695
- <div class="variablelist"><table border="0">
1696
- <col align="left" valign="top">
1697
- <tbody>
1698
- <tr>
1699
- <td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
1700
- <td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>
1701
- </td>
1702
- </tr>
1703
- <tr>
1704
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1705
- <td>week number
1706
- </td>
1707
- </tr>
1708
- </tbody>
1709
- </table></div>
1710
- </div>
1711
- <hr>
1712
- <div class="refsect2">
1713
- <a name="g-date-get-sunday-weeks-in-year"></a><h3>g_date_get_sunday_weeks_in_year ()</h3>
1714
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint8" title="guint8"><span class="returnvalue">guint8</span></a> g_date_get_sunday_weeks_in_year (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear"><span class="type">GDateYear</span></a> year</code></em>);</pre>
1715
- <p>
1716
- Returns the number of weeks in the year, where weeks are taken to start
1717
- on Sunday. Will be 52 or 53. The date must be valid. (Years always have 52
1718
- 7-day periods, plus 1 or 2 extra days depending on whether it's a leap
1719
- year. This function is basically telling you how many Sundays are in
1720
- the year, i.e. there are 53 Sundays if one of the extra days happens
1721
- to be a Sunday.)
1722
- </p>
1723
- <div class="variablelist"><table border="0">
1724
- <col align="left" valign="top">
1725
- <tbody>
1726
- <tr>
1727
- <td><p><span class="term"><em class="parameter"><code>year</code></em> :</span></p></td>
1728
- <td>year to count weeks in
1729
- </td>
1730
- </tr>
1731
- <tr>
1732
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1733
- <td>number of weeks
1734
- </td>
1735
- </tr>
1736
- </tbody>
1737
- </table></div>
1738
- </div>
1739
- <hr>
1740
- <div class="refsect2">
1741
- <a name="g-date-get-iso8601-week-of-year"></a><h3>g_date_get_iso8601_week_of_year ()</h3>
1742
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="returnvalue">guint</span></a> g_date_get_iso8601_week_of_year (<em class="parameter"><code>const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>);</pre>
1743
- <p>
1744
- Returns the week of the year, where weeks are interpreted according
1745
- to ISO 8601.
1746
- </p>
1747
- <div class="variablelist"><table border="0">
1748
- <col align="left" valign="top">
1749
- <tbody>
1750
- <tr>
1751
- <td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
1752
- <td>a valid <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>
1753
- </td>
1754
- </tr>
1755
- <tr>
1756
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1757
- <td> ISO 8601 week number of the year.
1758
-
1759
- </td>
1760
- </tr>
1761
- </tbody>
1762
- </table></div>
1763
- <p class="since">Since 2.6</p>
1764
- </div>
1765
- <hr>
1766
- <div class="refsect2">
1767
- <a name="g-date-strftime"></a><h3>g_date_strftime ()</h3>
1768
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="returnvalue">gsize</span></a> g_date_strftime (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *s</code></em>,
1769
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> slen</code></em>,
1770
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *format</code></em>,
1771
- <em class="parameter"><code>const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>);</pre>
1772
- <p>
1773
- Generates a printed representation of the date, in a
1774
- <a class="link" href="glib-running.html#setlocale" title="Locale">locale</a>-specific way. Works just like
1775
- the platform's C library <code class="function">strftime()</code> function, but only accepts date-related
1776
- formats; time-related formats give undefined results. Date must be valid.
1777
- Unlike <code class="function">strftime()</code> (which uses the locale encoding), works on a UTF-8 format
1778
- string and stores a UTF-8 result.
1779
- </p>
1780
- <p>
1781
- This function does not provide any conversion specifiers in addition
1782
- to those implemented by the platform's C library. For example, don't
1783
- expect that using <a class="link" href="glib-Date-and-Time-Functions.html#g-date-strftime" title="g_date_strftime ()"><code class="function">g_date_strftime()</code></a> would make the <code class="literal">F</code> provided by the C99
1784
- <code class="function">strftime()</code> work on Windows where the C library only complies to C89.
1785
- </p>
1786
- <div class="variablelist"><table border="0">
1787
- <col align="left" valign="top">
1788
- <tbody>
1789
- <tr>
1790
- <td><p><span class="term"><em class="parameter"><code>s</code></em> :</span></p></td>
1791
- <td>destination buffer
1792
- </td>
1793
- </tr>
1794
- <tr>
1795
- <td><p><span class="term"><em class="parameter"><code>slen</code></em> :</span></p></td>
1796
- <td>buffer size
1797
- </td>
1798
- </tr>
1799
- <tr>
1800
- <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
1801
- <td>format string
1802
- </td>
1803
- </tr>
1804
- <tr>
1805
- <td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
1806
- <td>valid <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a>
1807
- </td>
1808
- </tr>
1809
- <tr>
1810
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1811
- <td>number of characters written to the buffer, or 0 the buffer was too small
1812
- </td>
1813
- </tr>
1814
- </tbody>
1815
- </table></div>
1816
- </div>
1817
- <hr>
1818
- <div class="refsect2">
1819
- <a name="g-date-to-struct-tm"></a><h3>g_date_to_struct_tm ()</h3>
1820
- <pre class="programlisting"><span class="returnvalue">void</span> g_date_to_struct_tm (<em class="parameter"><code>const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>,
1821
- <em class="parameter"><code><span class="type">struct tm</span> *tm</code></em>);</pre>
1822
- <p>
1823
- Fills in the date-related bits of a <span class="structname">struct tm</span>
1824
- using the <em class="parameter"><code>date</code></em> value. Initializes the non-date parts with something
1825
- sane but meaningless.
1826
- </p>
1827
- <div class="variablelist"><table border="0">
1828
- <col align="left" valign="top">
1829
- <tbody>
1830
- <tr>
1831
- <td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
1832
- <td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> to set the <span class="structname">struct tm</span> from.
1833
- </td>
1834
- </tr>
1835
- <tr>
1836
- <td><p><span class="term"><em class="parameter"><code>tm</code></em> :</span></p></td>
1837
- <td>
1838
- <span class="structname">struct tm</span> to fill.
1839
- </td>
1840
- </tr>
1841
- </tbody>
1842
- </table></div>
1843
- </div>
1844
- <hr>
1845
- <div class="refsect2">
1846
- <a name="g-date-valid"></a><h3>g_date_valid ()</h3>
1847
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_date_valid (<em class="parameter"><code>const <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> *date</code></em>);</pre>
1848
- <p>
1849
- Returns <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> represents an existing day. The date must not
1850
- contain garbage; it should have been initialized with <a class="link" href="glib-Date-and-Time-Functions.html#g-date-clear" title="g_date_clear ()"><code class="function">g_date_clear()</code></a>
1851
- if it wasn't allocated by one of the <a class="link" href="glib-Date-and-Time-Functions.html#g-date-new" title="g_date_new ()"><code class="function">g_date_new()</code></a> variants.
1852
- </p>
1853
- <div class="variablelist"><table border="0">
1854
- <col align="left" valign="top">
1855
- <tbody>
1856
- <tr>
1857
- <td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
1858
- <td>a <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> to check
1859
- </td>
1860
- </tr>
1861
- <tr>
1862
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1863
- <td>Whether the date is valid
1864
- </td>
1865
- </tr>
1866
- </tbody>
1867
- </table></div>
1868
- </div>
1869
- <hr>
1870
- <div class="refsect2">
1871
- <a name="g-date-valid-day"></a><h3>g_date_valid_day ()</h3>
1872
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_date_valid_day (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDateDay" title="GDateDay"><span class="type">GDateDay</span></a> day</code></em>);</pre>
1873
- <p>
1874
- Returns <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the day of the month is valid (a day is valid if it's
1875
- between 1 and 31 inclusive).
1876
- </p>
1877
- <div class="variablelist"><table border="0">
1878
- <col align="left" valign="top">
1879
- <tbody>
1880
- <tr>
1881
- <td><p><span class="term"><em class="parameter"><code>day</code></em> :</span></p></td>
1882
- <td>day to check
1883
- </td>
1884
- </tr>
1885
- <tr>
1886
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1887
- <td>
1888
- <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the day is valid
1889
- </td>
1890
- </tr>
1891
- </tbody>
1892
- </table></div>
1893
- </div>
1894
- <hr>
1895
- <div class="refsect2">
1896
- <a name="g-date-valid-month"></a><h3>g_date_valid_month ()</h3>
1897
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_date_valid_month (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth" title="enum GDateMonth"><span class="type">GDateMonth</span></a> month</code></em>);</pre>
1898
- <p>
1899
- Returns <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the month value is valid. The 12 <a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth" title="enum GDateMonth"><span class="type">GDateMonth</span></a>
1900
- enumeration values are the only valid months.
1901
- </p>
1902
- <div class="variablelist"><table border="0">
1903
- <col align="left" valign="top">
1904
- <tbody>
1905
- <tr>
1906
- <td><p><span class="term"><em class="parameter"><code>month</code></em> :</span></p></td>
1907
- <td>month
1908
- </td>
1909
- </tr>
1910
- <tr>
1911
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1912
- <td>
1913
- <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the month is valid
1914
- </td>
1915
- </tr>
1916
- </tbody>
1917
- </table></div>
1918
- </div>
1919
- <hr>
1920
- <div class="refsect2">
1921
- <a name="g-date-valid-year"></a><h3>g_date_valid_year ()</h3>
1922
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_date_valid_year (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear"><span class="type">GDateYear</span></a> year</code></em>);</pre>
1923
- <p>
1924
- Returns <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the year is valid. Any year greater than 0 is valid,
1925
- though there is a 16-bit limit to what <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> will understand.
1926
- </p>
1927
- <div class="variablelist"><table border="0">
1928
- <col align="left" valign="top">
1929
- <tbody>
1930
- <tr>
1931
- <td><p><span class="term"><em class="parameter"><code>year</code></em> :</span></p></td>
1932
- <td>year
1933
- </td>
1934
- </tr>
1935
- <tr>
1936
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1937
- <td>
1938
- <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the year is valid
1939
- </td>
1940
- </tr>
1941
- </tbody>
1942
- </table></div>
1943
- </div>
1944
- <hr>
1945
- <div class="refsect2">
1946
- <a name="g-date-valid-dmy"></a><h3>g_date_valid_dmy ()</h3>
1947
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_date_valid_dmy (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDateDay" title="GDateDay"><span class="type">GDateDay</span></a> day</code></em>,
1948
- <em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDateMonth" title="enum GDateMonth"><span class="type">GDateMonth</span></a> month</code></em>,
1949
- <em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDateYear" title="GDateYear"><span class="type">GDateYear</span></a> year</code></em>);</pre>
1950
- <p>
1951
- Returns <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the day-month-year triplet forms a valid, existing day
1952
- in the range of days <a class="link" href="glib-Date-and-Time-Functions.html#GDate" title="GDate"><span class="type">GDate</span></a> understands (Year 1 or later, no more than
1953
- a few thousand years in the future).
1954
- </p>
1955
- <div class="variablelist"><table border="0">
1956
- <col align="left" valign="top">
1957
- <tbody>
1958
- <tr>
1959
- <td><p><span class="term"><em class="parameter"><code>day</code></em> :</span></p></td>
1960
- <td>day
1961
- </td>
1962
- </tr>
1963
- <tr>
1964
- <td><p><span class="term"><em class="parameter"><code>month</code></em> :</span></p></td>
1965
- <td>month
1966
- </td>
1967
- </tr>
1968
- <tr>
1969
- <td><p><span class="term"><em class="parameter"><code>year</code></em> :</span></p></td>
1970
- <td>year
1971
- </td>
1972
- </tr>
1973
- <tr>
1974
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1975
- <td>
1976
- <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the date is a valid one
1977
- </td>
1978
- </tr>
1979
- </tbody>
1980
- </table></div>
1981
- </div>
1982
- <hr>
1983
- <div class="refsect2">
1984
- <a name="g-date-valid-julian"></a><h3>g_date_valid_julian ()</h3>
1985
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_date_valid_julian (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint32" title="guint32"><span class="type">guint32</span></a> julian_date</code></em>);</pre>
1986
- <p>
1987
- Returns <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the Julian day is valid. Anything greater than zero
1988
- is basically a valid Julian, though there is a 32-bit limit.
1989
- </p>
1990
- <div class="variablelist"><table border="0">
1991
- <col align="left" valign="top">
1992
- <tbody>
1993
- <tr>
1994
- <td><p><span class="term"><em class="parameter"><code>julian_date</code></em> :</span></p></td>
1995
- <td>Julian day to check
1996
- </td>
1997
- </tr>
1998
- <tr>
1999
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2000
- <td>
2001
- <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the Julian day is valid
2002
- </td>
2003
- </tr>
2004
- </tbody>
2005
- </table></div>
2006
- </div>
2007
- <hr>
2008
- <div class="refsect2">
2009
- <a name="g-date-valid-weekday"></a><h3>g_date_valid_weekday ()</h3>
2010
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_date_valid_weekday (<em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GDateWeekday" title="enum GDateWeekday"><span class="type">GDateWeekday</span></a> weekday</code></em>);</pre>
2011
- <p>
2012
- Returns <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the weekday is valid. The seven <a class="link" href="glib-Date-and-Time-Functions.html#GDateWeekday" title="enum GDateWeekday"><span class="type">GDateWeekday</span></a> enumeration
2013
- values are the only valid weekdays.
2014
- </p>
2015
- <div class="variablelist"><table border="0">
2016
- <col align="left" valign="top">
2017
- <tbody>
2018
- <tr>
2019
- <td><p><span class="term"><em class="parameter"><code>weekday</code></em> :</span></p></td>
2020
- <td>weekday
2021
- </td>
2022
- </tr>
2023
- <tr>
2024
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2025
- <td>
2026
- <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the weekday is valid
2027
- </td>
2028
- </tr>
2029
- </tbody>
2030
- </table></div>
2031
- </div>
2032
- </div>
2033
- <div class="footnotes">
2034
- <br><hr width="100" align="left">
2035
- <div class="footnote"><p><sup>[<a name="ftn.id723118" href="#id723118" class="para">4</a>] </sup>
2036
- For the purposes of this function, leap year is every year divisible by
2037
- 4 unless that year is divisible by 100. If it is divisible by 100 it would
2038
- be a leap year only if that year is also divisible by 400.</p></div>
2039
- </div>
2040
- </div>
2041
- <div class="footer">
2042
- <hr>
2043
- Generated by GTK-Doc V1.15.1</div>
2044
- </body>
2045
- </html>