glib2 0.90.2-x86-mingw32

Sign up to get free protection for your applications and to get access to all the features.
Files changed (875) hide show
  1. data/ChangeLog +3115 -0
  2. data/README +40 -0
  3. data/Rakefile +69 -0
  4. data/ext/glib2/depend +10 -0
  5. data/ext/glib2/extconf.rb +61 -0
  6. data/ext/glib2/glib2.def +89 -0
  7. data/ext/glib2/rbgcompat.h +30 -0
  8. data/ext/glib2/rbglib.c +330 -0
  9. data/ext/glib2/rbglib.h +96 -0
  10. data/ext/glib2/rbglib_bookmarkfile.c +595 -0
  11. data/ext/glib2/rbglib_completion.c +192 -0
  12. data/ext/glib2/rbglib_convert.c +195 -0
  13. data/ext/glib2/rbglib_error.c +95 -0
  14. data/ext/glib2/rbglib_fileutils.c +83 -0
  15. data/ext/glib2/rbglib_i18n.c +44 -0
  16. data/ext/glib2/rbglib_int64.c +157 -0
  17. data/ext/glib2/rbglib_iochannel.c +883 -0
  18. data/ext/glib2/rbglib_keyfile.c +846 -0
  19. data/ext/glib2/rbglib_maincontext.c +915 -0
  20. data/ext/glib2/rbglib_mainloop.c +87 -0
  21. data/ext/glib2/rbglib_messages.c +150 -0
  22. data/ext/glib2/rbglib_pollfd.c +111 -0
  23. data/ext/glib2/rbglib_shell.c +68 -0
  24. data/ext/glib2/rbglib_source.c +190 -0
  25. data/ext/glib2/rbglib_spawn.c +345 -0
  26. data/ext/glib2/rbglib_threads.c +51 -0
  27. data/ext/glib2/rbglib_timer.c +127 -0
  28. data/ext/glib2/rbglib_unicode.c +611 -0
  29. data/ext/glib2/rbglib_utils.c +386 -0
  30. data/ext/glib2/rbglib_win32.c +136 -0
  31. data/ext/glib2/rbgobj_boxed.c +251 -0
  32. data/ext/glib2/rbgobj_closure.c +337 -0
  33. data/ext/glib2/rbgobj_convert.c +167 -0
  34. data/ext/glib2/rbgobj_enums.c +961 -0
  35. data/ext/glib2/rbgobj_fundamental.c +30 -0
  36. data/ext/glib2/rbgobj_object.c +892 -0
  37. data/ext/glib2/rbgobj_param.c +390 -0
  38. data/ext/glib2/rbgobj_paramspecs.c +305 -0
  39. data/ext/glib2/rbgobj_signal.c +963 -0
  40. data/ext/glib2/rbgobj_strv.c +61 -0
  41. data/ext/glib2/rbgobj_type.c +851 -0
  42. data/ext/glib2/rbgobj_typeinstance.c +121 -0
  43. data/ext/glib2/rbgobj_typeinterface.c +148 -0
  44. data/ext/glib2/rbgobj_typemodule.c +66 -0
  45. data/ext/glib2/rbgobj_typeplugin.c +49 -0
  46. data/ext/glib2/rbgobj_value.c +313 -0
  47. data/ext/glib2/rbgobj_valuearray.c +59 -0
  48. data/ext/glib2/rbgobj_valuetypes.c +298 -0
  49. data/ext/glib2/rbgobject.c +406 -0
  50. data/ext/glib2/rbgobject.h +265 -0
  51. data/ext/glib2/rbgprivate.h +88 -0
  52. data/ext/glib2/rbgutil.c +316 -0
  53. data/ext/glib2/rbgutil.h +82 -0
  54. data/ext/glib2/rbgutil_callback.c +231 -0
  55. data/extconf.rb +49 -0
  56. data/lib/1.8/glib2.so +0 -0
  57. data/lib/1.9/glib2.so +0 -0
  58. data/lib/glib-mkenums.rb +199 -0
  59. data/lib/glib2.rb +239 -0
  60. data/lib/gnome2-win32-binary-downloader.rb +92 -0
  61. data/lib/mkmf-gnome2.rb +377 -0
  62. data/sample/bookmarkfile.rb +66 -0
  63. data/sample/completion.rb +45 -0
  64. data/sample/idle.rb +41 -0
  65. data/sample/iochannel.rb +44 -0
  66. data/sample/keyfile.rb +62 -0
  67. data/sample/shell.rb +36 -0
  68. data/sample/spawn.rb +25 -0
  69. data/sample/timeout.rb +28 -0
  70. data/sample/timeout2.rb +35 -0
  71. data/sample/timer.rb +40 -0
  72. data/sample/type-register.rb +103 -0
  73. data/sample/type-register2.rb +104 -0
  74. data/sample/utils.rb +54 -0
  75. data/test/glib-test-init.rb +6 -0
  76. data/test/glib-test-utils.rb +12 -0
  77. data/test/run-test.rb +21 -0
  78. data/test/test_enum.rb +99 -0
  79. data/test/test_file_utils.rb +15 -0
  80. data/test/test_glib2.rb +120 -0
  81. data/test/test_iochannel.rb +275 -0
  82. data/test/test_key_file.rb +38 -0
  83. data/test/test_mkenums.rb +25 -0
  84. data/test/test_signal.rb +20 -0
  85. data/test/test_timeout.rb +28 -0
  86. data/test/test_unicode.rb +369 -0
  87. data/test/test_utils.rb +37 -0
  88. data/test/test_win32.rb +13 -0
  89. data/test-unit/COPYING +56 -0
  90. data/test-unit/GPL +340 -0
  91. data/test-unit/History.txt +232 -0
  92. data/test-unit/Manifest.txt +110 -0
  93. data/test-unit/PSFL +271 -0
  94. data/test-unit/README.txt +75 -0
  95. data/test-unit/Rakefile +53 -0
  96. data/test-unit/TODO +5 -0
  97. data/test-unit/bin/testrb +5 -0
  98. data/test-unit/html/bar.png +0 -0
  99. data/test-unit/html/bar.svg +153 -0
  100. data/test-unit/html/developer.png +0 -0
  101. data/test-unit/html/developer.svg +469 -0
  102. data/test-unit/html/famfamfam-logo.png +0 -0
  103. data/test-unit/html/favicon.ico +0 -0
  104. data/test-unit/html/favicon.png +0 -0
  105. data/test-unit/html/favicon.svg +82 -0
  106. data/test-unit/html/heading-mark.png +0 -0
  107. data/test-unit/html/heading-mark.svg +393 -0
  108. data/test-unit/html/index.html +247 -0
  109. data/test-unit/html/index.html.ja +270 -0
  110. data/test-unit/html/install.png +0 -0
  111. data/test-unit/html/install.svg +636 -0
  112. data/test-unit/html/jp.png +0 -0
  113. data/test-unit/html/kinotan-failure.png +0 -0
  114. data/test-unit/html/kinotan-pass.png +0 -0
  115. data/test-unit/html/logo.png +0 -0
  116. data/test-unit/html/logo.svg +483 -0
  117. data/test-unit/html/reference.png +0 -0
  118. data/test-unit/html/rubyforge.png +0 -0
  119. data/test-unit/html/tango-logo.png +0 -0
  120. data/test-unit/html/test-unit.css +339 -0
  121. data/test-unit/html/tutorial.png +0 -0
  122. data/test-unit/html/tutorial.svg +559 -0
  123. data/test-unit/html/us.png +0 -0
  124. data/test-unit/images/color-diff.png +0 -0
  125. data/test-unit/lib/test/unit/assertionfailederror.rb +25 -0
  126. data/test-unit/lib/test/unit/assertions.rb +1334 -0
  127. data/test-unit/lib/test/unit/attribute.rb +125 -0
  128. data/test-unit/lib/test/unit/autorunner.rb +363 -0
  129. data/test-unit/lib/test/unit/collector/descendant.rb +23 -0
  130. data/test-unit/lib/test/unit/collector/dir.rb +108 -0
  131. data/test-unit/lib/test/unit/collector/load.rb +144 -0
  132. data/test-unit/lib/test/unit/collector/objectspace.rb +34 -0
  133. data/test-unit/lib/test/unit/collector.rb +36 -0
  134. data/test-unit/lib/test/unit/color-scheme.rb +106 -0
  135. data/test-unit/lib/test/unit/color.rb +96 -0
  136. data/test-unit/lib/test/unit/diff.rb +740 -0
  137. data/test-unit/lib/test/unit/error.rb +130 -0
  138. data/test-unit/lib/test/unit/exceptionhandler.rb +39 -0
  139. data/test-unit/lib/test/unit/failure.rb +136 -0
  140. data/test-unit/lib/test/unit/fixture.rb +176 -0
  141. data/test-unit/lib/test/unit/notification.rb +129 -0
  142. data/test-unit/lib/test/unit/omission.rb +191 -0
  143. data/test-unit/lib/test/unit/pending.rb +150 -0
  144. data/test-unit/lib/test/unit/priority.rb +180 -0
  145. data/test-unit/lib/test/unit/runner/console.rb +52 -0
  146. data/test-unit/lib/test/unit/runner/emacs.rb +8 -0
  147. data/test-unit/lib/test/unit/runner/tap.rb +8 -0
  148. data/test-unit/lib/test/unit/testcase.rb +483 -0
  149. data/test-unit/lib/test/unit/testresult.rb +121 -0
  150. data/test-unit/lib/test/unit/testsuite.rb +110 -0
  151. data/test-unit/lib/test/unit/ui/console/outputlevel.rb +14 -0
  152. data/test-unit/lib/test/unit/ui/console/testrunner.rb +430 -0
  153. data/test-unit/lib/test/unit/ui/emacs/testrunner.rb +63 -0
  154. data/test-unit/lib/test/unit/ui/tap/testrunner.rb +82 -0
  155. data/test-unit/lib/test/unit/ui/testrunner.rb +53 -0
  156. data/test-unit/lib/test/unit/ui/testrunnermediator.rb +77 -0
  157. data/test-unit/lib/test/unit/ui/testrunnerutilities.rb +41 -0
  158. data/test-unit/lib/test/unit/util/backtracefilter.rb +42 -0
  159. data/test-unit/lib/test/unit/util/method-owner-finder.rb +28 -0
  160. data/test-unit/lib/test/unit/util/observable.rb +90 -0
  161. data/test-unit/lib/test/unit/util/output.rb +31 -0
  162. data/test-unit/lib/test/unit/util/procwrapper.rb +48 -0
  163. data/test-unit/lib/test/unit/version.rb +7 -0
  164. data/test-unit/lib/test/unit.rb +328 -0
  165. data/test-unit/sample/adder.rb +13 -0
  166. data/test-unit/sample/subtracter.rb +12 -0
  167. data/test-unit/sample/test_adder.rb +20 -0
  168. data/test-unit/sample/test_subtracter.rb +20 -0
  169. data/test-unit/sample/test_user.rb +23 -0
  170. data/test-unit/test/collector/test-descendant.rb +133 -0
  171. data/test-unit/test/collector/test-load.rb +442 -0
  172. data/test-unit/test/collector/test_dir.rb +406 -0
  173. data/test-unit/test/collector/test_objectspace.rb +100 -0
  174. data/test-unit/test/run-test.rb +15 -0
  175. data/test-unit/test/test-attribute.rb +86 -0
  176. data/test-unit/test/test-color-scheme.rb +69 -0
  177. data/test-unit/test/test-color.rb +47 -0
  178. data/test-unit/test/test-diff.rb +518 -0
  179. data/test-unit/test/test-emacs-runner.rb +60 -0
  180. data/test-unit/test/test-fixture.rb +287 -0
  181. data/test-unit/test/test-notification.rb +33 -0
  182. data/test-unit/test/test-omission.rb +81 -0
  183. data/test-unit/test/test-pending.rb +70 -0
  184. data/test-unit/test/test-priority.rb +119 -0
  185. data/test-unit/test/test-testcase.rb +544 -0
  186. data/test-unit/test/test_assertions.rb +1197 -0
  187. data/test-unit/test/test_error.rb +26 -0
  188. data/test-unit/test/test_failure.rb +33 -0
  189. data/test-unit/test/test_testresult.rb +113 -0
  190. data/test-unit/test/test_testsuite.rb +129 -0
  191. data/test-unit/test/testunit-test-util.rb +14 -0
  192. data/test-unit/test/ui/test_tap.rb +33 -0
  193. data/test-unit/test/ui/test_testrunmediator.rb +20 -0
  194. data/test-unit/test/util/test-method-owner-finder.rb +38 -0
  195. data/test-unit/test/util/test-output.rb +11 -0
  196. data/test-unit/test/util/test_backtracefilter.rb +41 -0
  197. data/test-unit/test/util/test_observable.rb +102 -0
  198. data/test-unit/test/util/test_procwrapper.rb +36 -0
  199. data/vendor/local/bin/envsubst.exe +0 -0
  200. data/vendor/local/bin/gettext.exe +0 -0
  201. data/vendor/local/bin/gettext.sh +123 -0
  202. data/vendor/local/bin/glib-genmarshal.exe +0 -0
  203. data/vendor/local/bin/glib-gettextize +188 -0
  204. data/vendor/local/bin/glib-mkenums +511 -0
  205. data/vendor/local/bin/gobject-query.exe +0 -0
  206. data/vendor/local/bin/gspawn-win32-helper-console.exe +0 -0
  207. data/vendor/local/bin/gspawn-win32-helper.exe +0 -0
  208. data/vendor/local/bin/intl.dll +0 -0
  209. data/vendor/local/bin/libasprintf-0.dll +0 -0
  210. data/vendor/local/bin/libgcc_s_dw2-1.dll +0 -0
  211. data/vendor/local/bin/libgio-2.0-0.dll +0 -0
  212. data/vendor/local/bin/libglib-2.0-0.dll +0 -0
  213. data/vendor/local/bin/libgmodule-2.0-0.dll +0 -0
  214. data/vendor/local/bin/libgobject-2.0-0.dll +0 -0
  215. data/vendor/local/bin/libgthread-2.0-0.dll +0 -0
  216. data/vendor/local/bin/ngettext.exe +0 -0
  217. data/vendor/local/include/autosprintf.h +66 -0
  218. data/vendor/local/include/glib-2.0/gio/gappinfo.h +237 -0
  219. data/vendor/local/include/glib-2.0/gio/gasyncinitable.h +119 -0
  220. data/vendor/local/include/glib-2.0/gio/gasyncresult.h +73 -0
  221. data/vendor/local/include/glib-2.0/gio/gbufferedinputstream.h +123 -0
  222. data/vendor/local/include/glib-2.0/gio/gbufferedoutputstream.h +82 -0
  223. data/vendor/local/include/glib-2.0/gio/gcancellable.h +103 -0
  224. data/vendor/local/include/glib-2.0/gio/gcharsetconverter.h +60 -0
  225. data/vendor/local/include/glib-2.0/gio/gcontenttype.h +57 -0
  226. data/vendor/local/include/glib-2.0/gio/gconverter.h +95 -0
  227. data/vendor/local/include/glib-2.0/gio/gconverterinputstream.h +80 -0
  228. data/vendor/local/include/glib-2.0/gio/gconverteroutputstream.h +80 -0
  229. data/vendor/local/include/glib-2.0/gio/gdatainputstream.h +133 -0
  230. data/vendor/local/include/glib-2.0/gio/gdataoutputstream.h +116 -0
  231. data/vendor/local/include/glib-2.0/gio/gdrive.h +225 -0
  232. data/vendor/local/include/glib-2.0/gio/gemblem.h +58 -0
  233. data/vendor/local/include/glib-2.0/gio/gemblemedicon.h +62 -0
  234. data/vendor/local/include/glib-2.0/gio/gfile.h +1017 -0
  235. data/vendor/local/include/glib-2.0/gio/gfileattribute.h +77 -0
  236. data/vendor/local/include/glib-2.0/gio/gfileenumerator.h +133 -0
  237. data/vendor/local/include/glib-2.0/gio/gfileicon.h +56 -0
  238. data/vendor/local/include/glib-2.0/gio/gfileinfo.h +951 -0
  239. data/vendor/local/include/glib-2.0/gio/gfileinputstream.h +112 -0
  240. data/vendor/local/include/glib-2.0/gio/gfileiostream.h +118 -0
  241. data/vendor/local/include/glib-2.0/gio/gfilemonitor.h +95 -0
  242. data/vendor/local/include/glib-2.0/gio/gfilenamecompleter.h +76 -0
  243. data/vendor/local/include/glib-2.0/gio/gfileoutputstream.h +119 -0
  244. data/vendor/local/include/glib-2.0/gio/gfilterinputstream.h +76 -0
  245. data/vendor/local/include/glib-2.0/gio/gfilteroutputstream.h +76 -0
  246. data/vendor/local/include/glib-2.0/gio/gicon.h +91 -0
  247. data/vendor/local/include/glib-2.0/gio/ginetaddress.h +103 -0
  248. data/vendor/local/include/glib-2.0/gio/ginetsocketaddress.h +69 -0
  249. data/vendor/local/include/glib-2.0/gio/ginitable.h +96 -0
  250. data/vendor/local/include/glib-2.0/gio/ginputstream.h +172 -0
  251. data/vendor/local/include/glib-2.0/gio/gio.h +101 -0
  252. data/vendor/local/include/glib-2.0/gio/gioenums.h +703 -0
  253. data/vendor/local/include/glib-2.0/gio/gioenumtypes.h +79 -0
  254. data/vendor/local/include/glib-2.0/gio/gioerror.h +48 -0
  255. data/vendor/local/include/glib-2.0/gio/giomodule.h +132 -0
  256. data/vendor/local/include/glib-2.0/gio/gioscheduler.h +52 -0
  257. data/vendor/local/include/glib-2.0/gio/giostream.h +112 -0
  258. data/vendor/local/include/glib-2.0/gio/giotypes.h +339 -0
  259. data/vendor/local/include/glib-2.0/gio/gloadableicon.h +97 -0
  260. data/vendor/local/include/glib-2.0/gio/gmemoryinputstream.h +82 -0
  261. data/vendor/local/include/glib-2.0/gio/gmemoryoutputstream.h +97 -0
  262. data/vendor/local/include/glib-2.0/gio/gmount.h +242 -0
  263. data/vendor/local/include/glib-2.0/gio/gmountoperation.h +123 -0
  264. data/vendor/local/include/glib-2.0/gio/gnativevolumemonitor.h +62 -0
  265. data/vendor/local/include/glib-2.0/gio/gnetworkaddress.h +69 -0
  266. data/vendor/local/include/glib-2.0/gio/gnetworkservice.h +69 -0
  267. data/vendor/local/include/glib-2.0/gio/goutputstream.h +207 -0
  268. data/vendor/local/include/glib-2.0/gio/gresolver.h +167 -0
  269. data/vendor/local/include/glib-2.0/gio/gseekable.h +99 -0
  270. data/vendor/local/include/glib-2.0/gio/gsimpleasyncresult.h +125 -0
  271. data/vendor/local/include/glib-2.0/gio/gsocket.h +176 -0
  272. data/vendor/local/include/glib-2.0/gio/gsocketaddress.h +79 -0
  273. data/vendor/local/include/glib-2.0/gio/gsocketaddressenumerator.h +89 -0
  274. data/vendor/local/include/glib-2.0/gio/gsocketclient.h +130 -0
  275. data/vendor/local/include/glib-2.0/gio/gsocketconnectable.h +68 -0
  276. data/vendor/local/include/glib-2.0/gio/gsocketconnection.h +91 -0
  277. data/vendor/local/include/glib-2.0/gio/gsocketcontrolmessage.h +105 -0
  278. data/vendor/local/include/glib-2.0/gio/gsocketlistener.h +138 -0
  279. data/vendor/local/include/glib-2.0/gio/gsocketservice.h +88 -0
  280. data/vendor/local/include/glib-2.0/gio/gsrvtarget.h +52 -0
  281. data/vendor/local/include/glib-2.0/gio/gtcpconnection.h +68 -0
  282. data/vendor/local/include/glib-2.0/gio/gthemedicon.h +63 -0
  283. data/vendor/local/include/glib-2.0/gio/gthreadedsocketservice.h +81 -0
  284. data/vendor/local/include/glib-2.0/gio/gvfs.h +125 -0
  285. data/vendor/local/include/glib-2.0/gio/gvolume.h +211 -0
  286. data/vendor/local/include/glib-2.0/gio/gvolumemonitor.h +151 -0
  287. data/vendor/local/include/glib-2.0/gio/gzlibcompressor.h +55 -0
  288. data/vendor/local/include/glib-2.0/gio/gzlibdecompressor.h +54 -0
  289. data/vendor/local/include/glib-2.0/glib/galloca.h +63 -0
  290. data/vendor/local/include/glib-2.0/glib/garray.h +179 -0
  291. data/vendor/local/include/glib-2.0/glib/gasyncqueue.h +120 -0
  292. data/vendor/local/include/glib-2.0/glib/gatomic.h +85 -0
  293. data/vendor/local/include/glib-2.0/glib/gbacktrace.h +68 -0
  294. data/vendor/local/include/glib-2.0/glib/gbase64.h +57 -0
  295. data/vendor/local/include/glib-2.0/glib/gbitlock.h +43 -0
  296. data/vendor/local/include/glib-2.0/glib/gbookmarkfile.h +191 -0
  297. data/vendor/local/include/glib-2.0/glib/gcache.h +69 -0
  298. data/vendor/local/include/glib-2.0/glib/gchecksum.h +86 -0
  299. data/vendor/local/include/glib-2.0/glib/gcompletion.h +77 -0
  300. data/vendor/local/include/glib-2.0/glib/gconvert.h +138 -0
  301. data/vendor/local/include/glib-2.0/glib/gdataset.h +122 -0
  302. data/vendor/local/include/glib-2.0/glib/gdate.h +263 -0
  303. data/vendor/local/include/glib-2.0/glib/gdir.h +52 -0
  304. data/vendor/local/include/glib-2.0/glib/gerror.h +98 -0
  305. data/vendor/local/include/glib-2.0/glib/gfileutils.h +128 -0
  306. data/vendor/local/include/glib-2.0/glib/ghash.h +166 -0
  307. data/vendor/local/include/glib-2.0/glib/ghook.h +181 -0
  308. data/vendor/local/include/glib-2.0/glib/ghostutils.h +40 -0
  309. data/vendor/local/include/glib-2.0/glib/gi18n-lib.h +38 -0
  310. data/vendor/local/include/glib-2.0/glib/gi18n.h +34 -0
  311. data/vendor/local/include/glib-2.0/glib/giochannel.h +366 -0
  312. data/vendor/local/include/glib-2.0/glib/gkeyfile.h +250 -0
  313. data/vendor/local/include/glib-2.0/glib/glist.h +120 -0
  314. data/vendor/local/include/glib-2.0/glib/gmacros.h +277 -0
  315. data/vendor/local/include/glib-2.0/glib/gmain.h +304 -0
  316. data/vendor/local/include/glib-2.0/glib/gmappedfile.h +49 -0
  317. data/vendor/local/include/glib-2.0/glib/gmarkup.h +163 -0
  318. data/vendor/local/include/glib-2.0/glib/gmem.h +203 -0
  319. data/vendor/local/include/glib-2.0/glib/gmessages.h +343 -0
  320. data/vendor/local/include/glib-2.0/glib/gnode.h +288 -0
  321. data/vendor/local/include/glib-2.0/glib/goption.h +370 -0
  322. data/vendor/local/include/glib-2.0/glib/gpattern.h +49 -0
  323. data/vendor/local/include/glib-2.0/glib/gpoll.h +93 -0
  324. data/vendor/local/include/glib-2.0/glib/gprimes.h +51 -0
  325. data/vendor/local/include/glib-2.0/glib/gprintf.h +52 -0
  326. data/vendor/local/include/glib-2.0/glib/gqsort.h +46 -0
  327. data/vendor/local/include/glib-2.0/glib/gquark.h +52 -0
  328. data/vendor/local/include/glib-2.0/glib/gqueue.h +127 -0
  329. data/vendor/local/include/glib-2.0/glib/grand.h +85 -0
  330. data/vendor/local/include/glib-2.0/glib/gregex.h +243 -0
  331. data/vendor/local/include/glib-2.0/glib/grel.h +97 -0
  332. data/vendor/local/include/glib-2.0/glib/gscanner.h +278 -0
  333. data/vendor/local/include/glib-2.0/glib/gsequence.h +128 -0
  334. data/vendor/local/include/glib-2.0/glib/gshell.h +55 -0
  335. data/vendor/local/include/glib-2.0/glib/gslice.h +86 -0
  336. data/vendor/local/include/glib-2.0/glib/gslist.h +114 -0
  337. data/vendor/local/include/glib-2.0/glib/gspawn.h +139 -0
  338. data/vendor/local/include/glib-2.0/glib/gstdio.h +159 -0
  339. data/vendor/local/include/glib-2.0/glib/gstrfuncs.h +267 -0
  340. data/vendor/local/include/glib-2.0/glib/gstring.h +178 -0
  341. data/vendor/local/include/glib-2.0/glib/gtestutils.h +292 -0
  342. data/vendor/local/include/glib-2.0/glib/gthread.h +408 -0
  343. data/vendor/local/include/glib-2.0/glib/gthreadpool.h +114 -0
  344. data/vendor/local/include/glib-2.0/glib/gtimer.h +65 -0
  345. data/vendor/local/include/glib-2.0/glib/gtree.h +91 -0
  346. data/vendor/local/include/glib-2.0/glib/gtypes.h +451 -0
  347. data/vendor/local/include/glib-2.0/glib/gunicode.h +404 -0
  348. data/vendor/local/include/glib-2.0/glib/gurifuncs.h +81 -0
  349. data/vendor/local/include/glib-2.0/glib/gutils.h +490 -0
  350. data/vendor/local/include/glib-2.0/glib/gvariant.h +224 -0
  351. data/vendor/local/include/glib-2.0/glib/gvarianttype.h +305 -0
  352. data/vendor/local/include/glib-2.0/glib/gwin32.h +114 -0
  353. data/vendor/local/include/glib-2.0/glib-object.h +41 -0
  354. data/vendor/local/include/glib-2.0/glib.h +97 -0
  355. data/vendor/local/include/glib-2.0/gmodule.h +101 -0
  356. data/vendor/local/include/glib-2.0/gobject/gboxed.h +236 -0
  357. data/vendor/local/include/glib-2.0/gobject/gclosure.h +251 -0
  358. data/vendor/local/include/glib-2.0/gobject/genums.h +261 -0
  359. data/vendor/local/include/glib-2.0/gobject/gmarshal.h +169 -0
  360. data/vendor/local/include/glib-2.0/gobject/gobject.h +562 -0
  361. data/vendor/local/include/glib-2.0/gobject/gobjectnotifyqueue.c +166 -0
  362. data/vendor/local/include/glib-2.0/gobject/gparam.h +410 -0
  363. data/vendor/local/include/glib-2.0/gobject/gparamspecs.h +1083 -0
  364. data/vendor/local/include/glib-2.0/gobject/gsignal.h +509 -0
  365. data/vendor/local/include/glib-2.0/gobject/gsourceclosure.h +51 -0
  366. data/vendor/local/include/glib-2.0/gobject/gtype.h +1608 -0
  367. data/vendor/local/include/glib-2.0/gobject/gtypemodule.h +263 -0
  368. data/vendor/local/include/glib-2.0/gobject/gtypeplugin.h +134 -0
  369. data/vendor/local/include/glib-2.0/gobject/gvalue.h +159 -0
  370. data/vendor/local/include/glib-2.0/gobject/gvaluearray.h +77 -0
  371. data/vendor/local/include/glib-2.0/gobject/gvaluecollector.h +222 -0
  372. data/vendor/local/include/glib-2.0/gobject/gvaluetypes.h +243 -0
  373. data/vendor/local/include/libintl.h +464 -0
  374. data/vendor/local/lib/GNU.Gettext.dll +0 -0
  375. data/vendor/local/lib/gio-2.0.def +800 -0
  376. data/vendor/local/lib/gio-2.0.lib +0 -0
  377. data/vendor/local/lib/glib-2.0/include/glibconfig.h +284 -0
  378. data/vendor/local/lib/glib-2.0.def +1381 -0
  379. data/vendor/local/lib/glib-2.0.lib +0 -0
  380. data/vendor/local/lib/gmodule-2.0.def +11 -0
  381. data/vendor/local/lib/gmodule-2.0.lib +0 -0
  382. data/vendor/local/lib/gobject-2.0.def +349 -0
  383. data/vendor/local/lib/gobject-2.0.lib +0 -0
  384. data/vendor/local/lib/gthread-2.0.def +3 -0
  385. data/vendor/local/lib/gthread-2.0.lib +0 -0
  386. data/vendor/local/lib/intl.lib +0 -0
  387. data/vendor/local/lib/libasprintf.dll.a +0 -0
  388. data/vendor/local/lib/libgio-2.0.dll.a +0 -0
  389. data/vendor/local/lib/libglib-2.0.dll.a +0 -0
  390. data/vendor/local/lib/libgmodule-2.0.dll.a +0 -0
  391. data/vendor/local/lib/libgobject-2.0.dll.a +0 -0
  392. data/vendor/local/lib/libgthread-2.0.dll.a +0 -0
  393. data/vendor/local/lib/libintl.def +31 -0
  394. data/vendor/local/lib/libintl.dll.a +0 -0
  395. data/vendor/local/lib/pkgconfig/gio-2.0.pc +14 -0
  396. data/vendor/local/lib/pkgconfig/glib-2.0.pc +15 -0
  397. data/vendor/local/lib/pkgconfig/gmodule-2.0.pc +14 -0
  398. data/vendor/local/lib/pkgconfig/gmodule-no-export-2.0.pc +14 -0
  399. data/vendor/local/lib/pkgconfig/gobject-2.0.pc +11 -0
  400. data/vendor/local/lib/pkgconfig/gthread-2.0.pc +11 -0
  401. data/vendor/local/manifest/gettext-runtime-dev_0.18.1.1-2_win32.mft +81 -0
  402. data/vendor/local/manifest/gettext-runtime_0.18.1.1-2_win32.mft +3 -0
  403. data/vendor/local/manifest/glib-dev_2.24.2-2_win32.mft +491 -0
  404. data/vendor/local/manifest/glib_2.24.2-2_win32.mft +101 -0
  405. data/vendor/local/share/aclocal/glib-2.0.m4 +211 -0
  406. data/vendor/local/share/aclocal/glib-gettext.m4 +432 -0
  407. data/vendor/local/share/doc/gettext/bind_textdomain_codeset.3.html +165 -0
  408. data/vendor/local/share/doc/gettext/bindtextdomain.3.html +160 -0
  409. data/vendor/local/share/doc/gettext/csharpdoc/GNU_Gettext.html +8 -0
  410. data/vendor/local/share/doc/gettext/csharpdoc/GNU_Gettext_GettextResourceManager.html +305 -0
  411. data/vendor/local/share/doc/gettext/csharpdoc/GNU_Gettext_GettextResourceSet.html +356 -0
  412. data/vendor/local/share/doc/gettext/csharpdoc/begin.html +11 -0
  413. data/vendor/local/share/doc/gettext/csharpdoc/index.html +10 -0
  414. data/vendor/local/share/doc/gettext/csharpdoc/namespaces.html +6 -0
  415. data/vendor/local/share/doc/gettext/envsubst.1.html +213 -0
  416. data/vendor/local/share/doc/gettext/gettext.1.html +266 -0
  417. data/vendor/local/share/doc/gettext/gettext.3.html +186 -0
  418. data/vendor/local/share/doc/gettext/ngettext.1.html +280 -0
  419. data/vendor/local/share/doc/gettext/ngettext.3.html +143 -0
  420. data/vendor/local/share/doc/gettext/textdomain.3.html +150 -0
  421. data/vendor/local/share/doc/glib-2.24.2/COPYING +482 -0
  422. data/vendor/local/share/doc/glib-dev-2.24.2/COPYING +482 -0
  423. data/vendor/local/share/doc/libasprintf/autosprintf_all.html +174 -0
  424. data/vendor/local/share/glib-2.0/gdb/glib.py +252 -0
  425. data/vendor/local/share/glib-2.0/gdb/gobject.py +305 -0
  426. data/vendor/local/share/glib-2.0/gettext/mkinstalldirs +111 -0
  427. data/vendor/local/share/glib-2.0/gettext/po/Makefile.in.in +277 -0
  428. data/vendor/local/share/gtk-doc/html/gio/GAppInfo.html +1390 -0
  429. data/vendor/local/share/gtk-doc/html/gio/GAsyncInitable.html +531 -0
  430. data/vendor/local/share/gtk-doc/html/gio/GAsyncResult.html +343 -0
  431. data/vendor/local/share/gtk-doc/html/gio/GBufferedInputStream.html +568 -0
  432. data/vendor/local/share/gtk-doc/html/gio/GBufferedOutputStream.html +295 -0
  433. data/vendor/local/share/gtk-doc/html/gio/GCancellable.html +620 -0
  434. data/vendor/local/share/gtk-doc/html/gio/GCharsetConverter.html +245 -0
  435. data/vendor/local/share/gtk-doc/html/gio/GConverter.html +388 -0
  436. data/vendor/local/share/gtk-doc/html/gio/GDataInputStream.html +993 -0
  437. data/vendor/local/share/gtk-doc/html/gio/GDataOutputStream.html +544 -0
  438. data/vendor/local/share/gtk-doc/html/gio/GDrive.html +1416 -0
  439. data/vendor/local/share/gtk-doc/html/gio/GEmblem.html +272 -0
  440. data/vendor/local/share/gtk-doc/html/gio/GEmblemedIcon.html +206 -0
  441. data/vendor/local/share/gtk-doc/html/gio/GFile.html +7450 -0
  442. data/vendor/local/share/gtk-doc/html/gio/GFileDescriptorBased.html +115 -0
  443. data/vendor/local/share/gtk-doc/html/gio/GFileEnumerator.html +520 -0
  444. data/vendor/local/share/gtk-doc/html/gio/GFileIOStream.html +312 -0
  445. data/vendor/local/share/gtk-doc/html/gio/GFileIcon.html +155 -0
  446. data/vendor/local/share/gtk-doc/html/gio/GFileInfo.html +3116 -0
  447. data/vendor/local/share/gtk-doc/html/gio/GFileInputStream.html +262 -0
  448. data/vendor/local/share/gtk-doc/html/gio/GFileMonitor.html +353 -0
  449. data/vendor/local/share/gtk-doc/html/gio/GFileOutputStream.html +301 -0
  450. data/vendor/local/share/gtk-doc/html/gio/GFilenameCompleter.html +217 -0
  451. data/vendor/local/share/gtk-doc/html/gio/GFilterInputStream.html +182 -0
  452. data/vendor/local/share/gtk-doc/html/gio/GFilterOutputStream.html +183 -0
  453. data/vendor/local/share/gtk-doc/html/gio/GIOModule.html +261 -0
  454. data/vendor/local/share/gtk-doc/html/gio/GIOStream.html +479 -0
  455. data/vendor/local/share/gtk-doc/html/gio/GIcon.html +331 -0
  456. data/vendor/local/share/gtk-doc/html/gio/GInetAddress.html +717 -0
  457. data/vendor/local/share/gtk-doc/html/gio/GInetSocketAddress.html +195 -0
  458. data/vendor/local/share/gtk-doc/html/gio/GInitable.html +388 -0
  459. data/vendor/local/share/gtk-doc/html/gio/GInputStream.html +808 -0
  460. data/vendor/local/share/gtk-doc/html/gio/GLoadableIcon.html +301 -0
  461. data/vendor/local/share/gtk-doc/html/gio/GMemoryInputStream.html +185 -0
  462. data/vendor/local/share/gtk-doc/html/gio/GMemoryOutputStream.html +362 -0
  463. data/vendor/local/share/gtk-doc/html/gio/GMount.html +1465 -0
  464. data/vendor/local/share/gtk-doc/html/gio/GMountOperation.html +848 -0
  465. data/vendor/local/share/gtk-doc/html/gio/GNetworkAddress.html +263 -0
  466. data/vendor/local/share/gtk-doc/html/gio/GNetworkService.html +248 -0
  467. data/vendor/local/share/gtk-doc/html/gio/GOutputStream.html +1006 -0
  468. data/vendor/local/share/gtk-doc/html/gio/GResolver.html +787 -0
  469. data/vendor/local/share/gtk-doc/html/gio/GSeekable.html +350 -0
  470. data/vendor/local/share/gtk-doc/html/gio/GSimpleAsyncResult.html +979 -0
  471. data/vendor/local/share/gtk-doc/html/gio/GSocket.html +2152 -0
  472. data/vendor/local/share/gtk-doc/html/gio/GSocketAddress.html +297 -0
  473. data/vendor/local/share/gtk-doc/html/gio/GSocketClient.html +930 -0
  474. data/vendor/local/share/gtk-doc/html/gio/GSocketConnectable.html +428 -0
  475. data/vendor/local/share/gtk-doc/html/gio/GSocketConnection.html +548 -0
  476. data/vendor/local/share/gtk-doc/html/gio/GSocketControlMessage.html +274 -0
  477. data/vendor/local/share/gtk-doc/html/gio/GSocketListener.html +741 -0
  478. data/vendor/local/share/gtk-doc/html/gio/GSocketService.html +258 -0
  479. data/vendor/local/share/gtk-doc/html/gio/GThemedIcon.html +377 -0
  480. data/vendor/local/share/gtk-doc/html/gio/GThreadedSocketService.html +197 -0
  481. data/vendor/local/share/gtk-doc/html/gio/GUnixFDList.html +381 -0
  482. data/vendor/local/share/gtk-doc/html/gio/GUnixFDMessage.html +280 -0
  483. data/vendor/local/share/gtk-doc/html/gio/GUnixInputStream.html +237 -0
  484. data/vendor/local/share/gtk-doc/html/gio/GUnixOutputStream.html +237 -0
  485. data/vendor/local/share/gtk-doc/html/gio/GUnixSocketAddress.html +306 -0
  486. data/vendor/local/share/gtk-doc/html/gio/GVfs.html +274 -0
  487. data/vendor/local/share/gtk-doc/html/gio/GVolume.html +1028 -0
  488. data/vendor/local/share/gtk-doc/html/gio/GVolumeMonitor.html +709 -0
  489. data/vendor/local/share/gtk-doc/html/gio/GZlibCompressor.html +180 -0
  490. data/vendor/local/share/gtk-doc/html/gio/GZlibDecompressor.html +128 -0
  491. data/vendor/local/share/gtk-doc/html/gio/api-index-2-18.html +153 -0
  492. data/vendor/local/share/gtk-doc/html/gio/api-index-2-20.html +155 -0
  493. data/vendor/local/share/gtk-doc/html/gio/api-index-2-22.html +1088 -0
  494. data/vendor/local/share/gtk-doc/html/gio/api-index-2-24.html +206 -0
  495. data/vendor/local/share/gtk-doc/html/gio/api-index-deprecated.html +97 -0
  496. data/vendor/local/share/gtk-doc/html/gio/api-index-full.html +4499 -0
  497. data/vendor/local/share/gtk-doc/html/gio/async.html +44 -0
  498. data/vendor/local/share/gtk-doc/html/gio/ch01.html +171 -0
  499. data/vendor/local/share/gtk-doc/html/gio/ch02.html +45 -0
  500. data/vendor/local/share/gtk-doc/html/gio/ch03.html +80 -0
  501. data/vendor/local/share/gtk-doc/html/gio/ch19.html +75 -0
  502. data/vendor/local/share/gtk-doc/html/gio/ch20.html +217 -0
  503. data/vendor/local/share/gtk-doc/html/gio/ch20s02.html +41 -0
  504. data/vendor/local/share/gtk-doc/html/gio/ch20s03.html +39 -0
  505. data/vendor/local/share/gtk-doc/html/gio/conversion.html +44 -0
  506. data/vendor/local/share/gtk-doc/html/gio/extending-gio.html +96 -0
  507. data/vendor/local/share/gtk-doc/html/gio/extending.html +41 -0
  508. data/vendor/local/share/gtk-doc/html/gio/failable_initialization.html +38 -0
  509. data/vendor/local/share/gtk-doc/html/gio/file_mon.html +33 -0
  510. data/vendor/local/share/gtk-doc/html/gio/file_ops.html +50 -0
  511. data/vendor/local/share/gtk-doc/html/gio/gio-Desktop-file-based-GAppInfo.html +339 -0
  512. data/vendor/local/share/gtk-doc/html/gio/gio-Extension-Points.html +465 -0
  513. data/vendor/local/share/gtk-doc/html/gio/gio-GContentType.html +381 -0
  514. data/vendor/local/share/gtk-doc/html/gio/gio-GConverterInputstream.html +163 -0
  515. data/vendor/local/share/gtk-doc/html/gio/gio-GConverterOutputstream.html +163 -0
  516. data/vendor/local/share/gtk-doc/html/gio/gio-GFileAttribute.html +927 -0
  517. data/vendor/local/share/gtk-doc/html/gio/gio-GIOError.html +328 -0
  518. data/vendor/local/share/gtk-doc/html/gio/gio-GIOScheduler.html +297 -0
  519. data/vendor/local/share/gtk-doc/html/gio/gio-GSrvTarget.html +313 -0
  520. data/vendor/local/share/gtk-doc/html/gio/gio-Unix-Mounts.html +918 -0
  521. data/vendor/local/share/gtk-doc/html/gio/gio-hierarchy.html +107 -0
  522. data/vendor/local/share/gtk-doc/html/gio/gio.devhelp +1235 -0
  523. data/vendor/local/share/gtk-doc/html/gio/gio.devhelp2 +1384 -0
  524. data/vendor/local/share/gtk-doc/html/gio/gvfs-overview.png +0 -0
  525. data/vendor/local/share/gtk-doc/html/gio/highlevel-socket.html +47 -0
  526. data/vendor/local/share/gtk-doc/html/gio/home.png +0 -0
  527. data/vendor/local/share/gtk-doc/html/gio/icons.html +50 -0
  528. data/vendor/local/share/gtk-doc/html/gio/index.html +318 -0
  529. data/vendor/local/share/gtk-doc/html/gio/index.sgml +1795 -0
  530. data/vendor/local/share/gtk-doc/html/gio/left.png +0 -0
  531. data/vendor/local/share/gtk-doc/html/gio/migrating.html +42 -0
  532. data/vendor/local/share/gtk-doc/html/gio/networking.html +57 -0
  533. data/vendor/local/share/gtk-doc/html/gio/pt01.html +39 -0
  534. data/vendor/local/share/gtk-doc/html/gio/pt02.html +293 -0
  535. data/vendor/local/share/gtk-doc/html/gio/resolver.html +47 -0
  536. data/vendor/local/share/gtk-doc/html/gio/right.png +0 -0
  537. data/vendor/local/share/gtk-doc/html/gio/streaming.html +92 -0
  538. data/vendor/local/share/gtk-doc/html/gio/style.css +257 -0
  539. data/vendor/local/share/gtk-doc/html/gio/types.html +41 -0
  540. data/vendor/local/share/gtk-doc/html/gio/up.png +0 -0
  541. data/vendor/local/share/gtk-doc/html/gio/utils.html +33 -0
  542. data/vendor/local/share/gtk-doc/html/gio/volume_mon.html +47 -0
  543. data/vendor/local/share/gtk-doc/html/glib/api-index-2-10.html +180 -0
  544. data/vendor/local/share/gtk-doc/html/glib/api-index-2-12.html +312 -0
  545. data/vendor/local/share/gtk-doc/html/glib/api-index-2-14.html +563 -0
  546. data/vendor/local/share/gtk-doc/html/glib/api-index-2-16.html +362 -0
  547. data/vendor/local/share/gtk-doc/html/glib/api-index-2-18.html +102 -0
  548. data/vendor/local/share/gtk-doc/html/glib/api-index-2-2.html +124 -0
  549. data/vendor/local/share/gtk-doc/html/glib/api-index-2-20.html +83 -0
  550. data/vendor/local/share/gtk-doc/html/glib/api-index-2-22.html +194 -0
  551. data/vendor/local/share/gtk-doc/html/glib/api-index-2-24.html +419 -0
  552. data/vendor/local/share/gtk-doc/html/glib/api-index-2-4.html +389 -0
  553. data/vendor/local/share/gtk-doc/html/glib/api-index-2-6.html +413 -0
  554. data/vendor/local/share/gtk-doc/html/glib/api-index-2-8.html +158 -0
  555. data/vendor/local/share/gtk-doc/html/glib/api-index-deprecated.html +340 -0
  556. data/vendor/local/share/gtk-doc/html/glib/api-index-full.html +7835 -0
  557. data/vendor/local/share/gtk-doc/html/glib/file-name-encodings.png +0 -0
  558. data/vendor/local/share/gtk-doc/html/glib/glib-Arrays.html +893 -0
  559. data/vendor/local/share/gtk-doc/html/glib/glib-Asynchronous-Queues.html +818 -0
  560. data/vendor/local/share/gtk-doc/html/glib/glib-Atomic-Operations.html +413 -0
  561. data/vendor/local/share/gtk-doc/html/glib/glib-Automatic-String-Completion.html +430 -0
  562. data/vendor/local/share/gtk-doc/html/glib/glib-Balanced-Binary-Trees.html +802 -0
  563. data/vendor/local/share/gtk-doc/html/glib/glib-Base64-Encoding.html +372 -0
  564. data/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html +500 -0
  565. data/vendor/local/share/gtk-doc/html/glib/glib-Bookmark-file-parser.html +2054 -0
  566. data/vendor/local/share/gtk-doc/html/glib/glib-Byte-Arrays.html +560 -0
  567. data/vendor/local/share/gtk-doc/html/glib/glib-Byte-Order-Macros.html +1686 -0
  568. data/vendor/local/share/gtk-doc/html/glib/glib-Caches.html +398 -0
  569. data/vendor/local/share/gtk-doc/html/glib/glib-Character-Set-Conversion.html +1187 -0
  570. data/vendor/local/share/gtk-doc/html/glib/glib-Commandline-option-parser.html +1665 -0
  571. data/vendor/local/share/gtk-doc/html/glib/glib-Data-Checksums.html +460 -0
  572. data/vendor/local/share/gtk-doc/html/glib/glib-Datasets.html +528 -0
  573. data/vendor/local/share/gtk-doc/html/glib/glib-Date-and-Time-Functions.html +2042 -0
  574. data/vendor/local/share/gtk-doc/html/glib/glib-Double-ended-Queues.html +1278 -0
  575. data/vendor/local/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html +1406 -0
  576. data/vendor/local/share/gtk-doc/html/glib/glib-Dynamic-Loading-of-Modules.html +548 -0
  577. data/vendor/local/share/gtk-doc/html/glib/glib-Error-Reporting.html +1023 -0
  578. data/vendor/local/share/gtk-doc/html/glib/glib-File-Utilities.html +1810 -0
  579. data/vendor/local/share/gtk-doc/html/glib/glib-GVariant.html +3798 -0
  580. data/vendor/local/share/gtk-doc/html/glib/glib-GVariantType.html +1815 -0
  581. data/vendor/local/share/gtk-doc/html/glib/glib-Glob-style-pattern-matching.html +295 -0
  582. data/vendor/local/share/gtk-doc/html/glib/glib-Hash-Tables.html +1512 -0
  583. data/vendor/local/share/gtk-doc/html/glib/glib-Hook-Functions.html +1367 -0
  584. data/vendor/local/share/gtk-doc/html/glib/glib-Hostname-Utilities.html +229 -0
  585. data/vendor/local/share/gtk-doc/html/glib/glib-I18N.html +629 -0
  586. data/vendor/local/share/gtk-doc/html/glib/glib-IO-Channels.html +2196 -0
  587. data/vendor/local/share/gtk-doc/html/glib/glib-Key-value-file-parser.html +2556 -0
  588. data/vendor/local/share/gtk-doc/html/glib/glib-Keyed-Data-Lists.html +612 -0
  589. data/vendor/local/share/gtk-doc/html/glib/glib-Lexical-Scanner.html +1451 -0
  590. data/vendor/local/share/gtk-doc/html/glib/glib-Limits-of-Basic-Types.html +389 -0
  591. data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocation.html +1029 -0
  592. data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocators.html +141 -0
  593. data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Chunks.html +706 -0
  594. data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Slices.html +510 -0
  595. data/vendor/local/share/gtk-doc/html/glib/glib-Message-Logging.html +703 -0
  596. data/vendor/local/share/gtk-doc/html/glib/glib-Miscellaneous-Macros.html +1045 -0
  597. data/vendor/local/share/gtk-doc/html/glib/glib-Miscellaneous-Utility-Functions.html +1523 -0
  598. data/vendor/local/share/gtk-doc/html/glib/glib-N-ary-Trees.html +1466 -0
  599. data/vendor/local/share/gtk-doc/html/glib/glib-Numerical-Definitions.html +204 -0
  600. data/vendor/local/share/gtk-doc/html/glib/glib-Perl-compatible-regular-expressions.html +2648 -0
  601. data/vendor/local/share/gtk-doc/html/glib/glib-Pointer-Arrays.html +752 -0
  602. data/vendor/local/share/gtk-doc/html/glib/glib-Quarks.html +269 -0
  603. data/vendor/local/share/gtk-doc/html/glib/glib-Random-Numbers.html +578 -0
  604. data/vendor/local/share/gtk-doc/html/glib/glib-Relations-and-Tuples.html +483 -0
  605. data/vendor/local/share/gtk-doc/html/glib/glib-Sequences.html +1353 -0
  606. data/vendor/local/share/gtk-doc/html/glib/glib-Shell-related-Utilities.html +238 -0
  607. data/vendor/local/share/gtk-doc/html/glib/glib-Simple-XML-Subset-Parser.html +1283 -0
  608. data/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html +1212 -0
  609. data/vendor/local/share/gtk-doc/html/glib/glib-Spawning-Processes.html +924 -0
  610. data/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html +466 -0
  611. data/vendor/local/share/gtk-doc/html/glib/glib-String-Chunks.html +301 -0
  612. data/vendor/local/share/gtk-doc/html/glib/glib-String-Utility-Functions.html +2947 -0
  613. data/vendor/local/share/gtk-doc/html/glib/glib-Strings.html +1290 -0
  614. data/vendor/local/share/gtk-doc/html/glib/glib-Testing.html +1719 -0
  615. data/vendor/local/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html +3379 -0
  616. data/vendor/local/share/gtk-doc/html/glib/glib-Thread-Pools.html +606 -0
  617. data/vendor/local/share/gtk-doc/html/glib/glib-Threads.html +3411 -0
  618. data/vendor/local/share/gtk-doc/html/glib/glib-Timers.html +245 -0
  619. data/vendor/local/share/gtk-doc/html/glib/glib-Trash-Stacks.html +188 -0
  620. data/vendor/local/share/gtk-doc/html/glib/glib-Type-Conversion-Macros.html +263 -0
  621. data/vendor/local/share/gtk-doc/html/glib/glib-URI-Functions.html +314 -0
  622. data/vendor/local/share/gtk-doc/html/glib/glib-Unicode-Manipulation.html +3356 -0
  623. data/vendor/local/share/gtk-doc/html/glib/glib-Version-Information.html +150 -0
  624. data/vendor/local/share/gtk-doc/html/glib/glib-Warnings-and-Assertions.html +438 -0
  625. data/vendor/local/share/gtk-doc/html/glib/glib-Windows-Compatibility-Functions.html +476 -0
  626. data/vendor/local/share/gtk-doc/html/glib/glib-building.html +438 -0
  627. data/vendor/local/share/gtk-doc/html/glib/glib-changes.html +159 -0
  628. data/vendor/local/share/gtk-doc/html/glib/glib-compiling.html +118 -0
  629. data/vendor/local/share/gtk-doc/html/glib/glib-core.html +64 -0
  630. data/vendor/local/share/gtk-doc/html/glib/glib-cross-compiling.html +160 -0
  631. data/vendor/local/share/gtk-doc/html/glib/glib-data-types.html +120 -0
  632. data/vendor/local/share/gtk-doc/html/glib/glib-fundamentals.html +59 -0
  633. data/vendor/local/share/gtk-doc/html/glib/glib-gettextize.html +93 -0
  634. data/vendor/local/share/gtk-doc/html/glib/glib-regex-syntax.html +2395 -0
  635. data/vendor/local/share/gtk-doc/html/glib/glib-resources.html +121 -0
  636. data/vendor/local/share/gtk-doc/html/glib/glib-running.html +302 -0
  637. data/vendor/local/share/gtk-doc/html/glib/glib-utilities.html +112 -0
  638. data/vendor/local/share/gtk-doc/html/glib/glib.devhelp +2084 -0
  639. data/vendor/local/share/gtk-doc/html/glib/glib.devhelp2 +2556 -0
  640. data/vendor/local/share/gtk-doc/html/glib/glib.html +80 -0
  641. data/vendor/local/share/gtk-doc/html/glib/gtester-report.html +72 -0
  642. data/vendor/local/share/gtk-doc/html/glib/gtester.html +131 -0
  643. data/vendor/local/share/gtk-doc/html/glib/gvariant-format-strings.html +1171 -0
  644. data/vendor/local/share/gtk-doc/html/glib/home.png +0 -0
  645. data/vendor/local/share/gtk-doc/html/glib/index.html +336 -0
  646. data/vendor/local/share/gtk-doc/html/glib/index.sgml +2717 -0
  647. data/vendor/local/share/gtk-doc/html/glib/left.png +0 -0
  648. data/vendor/local/share/gtk-doc/html/glib/mainloop-states.gif +0 -0
  649. data/vendor/local/share/gtk-doc/html/glib/right.png +0 -0
  650. data/vendor/local/share/gtk-doc/html/glib/style.css +257 -0
  651. data/vendor/local/share/gtk-doc/html/glib/tools.html +41 -0
  652. data/vendor/local/share/gtk-doc/html/glib/up.png +0 -0
  653. data/vendor/local/share/gtk-doc/html/gobject/GTypeModule.html +710 -0
  654. data/vendor/local/share/gtk-doc/html/gobject/GTypePlugin.html +453 -0
  655. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-10.html +85 -0
  656. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-12.html +55 -0
  657. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-14.html +51 -0
  658. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-18.html +46 -0
  659. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-2.html +38 -0
  660. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-22.html +46 -0
  661. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-24.html +72 -0
  662. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-4.html +178 -0
  663. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-6.html +42 -0
  664. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-8.html +42 -0
  665. data/vendor/local/share/gtk-doc/html/gobject/api-index-deprecated.html +50 -0
  666. data/vendor/local/share/gtk-doc/html/gobject/api-index-full.html +2577 -0
  667. data/vendor/local/share/gtk-doc/html/gobject/ch01s02.html +136 -0
  668. data/vendor/local/share/gtk-doc/html/gobject/ch06s03.html +113 -0
  669. data/vendor/local/share/gtk-doc/html/gobject/chapter-gobject.html +293 -0
  670. data/vendor/local/share/gtk-doc/html/gobject/chapter-gtype.html +263 -0
  671. data/vendor/local/share/gtk-doc/html/gobject/chapter-intro.html +92 -0
  672. data/vendor/local/share/gtk-doc/html/gobject/chapter-signal.html +214 -0
  673. data/vendor/local/share/gtk-doc/html/gobject/glib-genmarshal.html +355 -0
  674. data/vendor/local/share/gtk-doc/html/gobject/glib-mkenums.html +295 -0
  675. data/vendor/local/share/gtk-doc/html/gobject/glue.png +0 -0
  676. data/vendor/local/share/gtk-doc/html/gobject/gobject-Boxed-Types.html +406 -0
  677. data/vendor/local/share/gtk-doc/html/gobject/gobject-Closures.html +2355 -0
  678. data/vendor/local/share/gtk-doc/html/gobject/gobject-Enumeration-and-Flag-Types.html +847 -0
  679. data/vendor/local/share/gtk-doc/html/gobject/gobject-GParamSpec.html +1423 -0
  680. data/vendor/local/share/gtk-doc/html/gobject/gobject-Generic-values.html +776 -0
  681. data/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html +2741 -0
  682. data/vendor/local/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html +5242 -0
  683. data/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html +2609 -0
  684. data/vendor/local/share/gtk-doc/html/gobject/gobject-Type-Information.html +4227 -0
  685. data/vendor/local/share/gtk-doc/html/gobject/gobject-Value-arrays.html +413 -0
  686. data/vendor/local/share/gtk-doc/html/gobject/gobject-Varargs-Value-Collection.html +230 -0
  687. data/vendor/local/share/gtk-doc/html/gobject/gobject-memory.html +234 -0
  688. data/vendor/local/share/gtk-doc/html/gobject/gobject-properties.html +270 -0
  689. data/vendor/local/share/gtk-doc/html/gobject/gobject-query.html +117 -0
  690. data/vendor/local/share/gtk-doc/html/gobject/gobject.devhelp +723 -0
  691. data/vendor/local/share/gtk-doc/html/gobject/gobject.devhelp2 +757 -0
  692. data/vendor/local/share/gtk-doc/html/gobject/gtype-conventions.html +143 -0
  693. data/vendor/local/share/gtk-doc/html/gobject/gtype-instantiable-classed.html +287 -0
  694. data/vendor/local/share/gtk-doc/html/gobject/gtype-non-instantiable-classed.html +316 -0
  695. data/vendor/local/share/gtk-doc/html/gobject/gtype-non-instantiable.html +76 -0
  696. data/vendor/local/share/gtk-doc/html/gobject/home.png +0 -0
  697. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-chainup.html +100 -0
  698. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-code.html +86 -0
  699. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-construction.html +113 -0
  700. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-destruction.html +122 -0
  701. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-methods.html +257 -0
  702. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject.html +283 -0
  703. data/vendor/local/share/gtk-doc/html/gobject/howto-interface-implement.html +125 -0
  704. data/vendor/local/share/gtk-doc/html/gobject/howto-interface-properties.html +167 -0
  705. data/vendor/local/share/gtk-doc/html/gobject/howto-interface.html +160 -0
  706. data/vendor/local/share/gtk-doc/html/gobject/howto-signals.html +121 -0
  707. data/vendor/local/share/gtk-doc/html/gobject/index.html +187 -0
  708. data/vendor/local/share/gtk-doc/html/gobject/index.sgml +734 -0
  709. data/vendor/local/share/gtk-doc/html/gobject/left.png +0 -0
  710. data/vendor/local/share/gtk-doc/html/gobject/pr01.html +72 -0
  711. data/vendor/local/share/gtk-doc/html/gobject/pt01.html +80 -0
  712. data/vendor/local/share/gtk-doc/html/gobject/pt02.html +66 -0
  713. data/vendor/local/share/gtk-doc/html/gobject/pt03.html +55 -0
  714. data/vendor/local/share/gtk-doc/html/gobject/right.png +0 -0
  715. data/vendor/local/share/gtk-doc/html/gobject/rn01.html +82 -0
  716. data/vendor/local/share/gtk-doc/html/gobject/rn02.html +47 -0
  717. data/vendor/local/share/gtk-doc/html/gobject/signal.html +377 -0
  718. data/vendor/local/share/gtk-doc/html/gobject/style.css +257 -0
  719. data/vendor/local/share/gtk-doc/html/gobject/tools-ginspector.html +35 -0
  720. data/vendor/local/share/gtk-doc/html/gobject/tools-gob.html +40 -0
  721. data/vendor/local/share/gtk-doc/html/gobject/tools-gtkdoc.html +63 -0
  722. data/vendor/local/share/gtk-doc/html/gobject/tools-refdb.html +55 -0
  723. data/vendor/local/share/gtk-doc/html/gobject/tools-vala.html +43 -0
  724. data/vendor/local/share/gtk-doc/html/gobject/up.png +0 -0
  725. data/vendor/local/share/locale/af/LC_MESSAGES/glib20.mo +0 -0
  726. data/vendor/local/share/locale/am/LC_MESSAGES/glib20.mo +0 -0
  727. data/vendor/local/share/locale/ar/LC_MESSAGES/glib20.mo +0 -0
  728. data/vendor/local/share/locale/as/LC_MESSAGES/glib20.mo +0 -0
  729. data/vendor/local/share/locale/ast/LC_MESSAGES/glib20.mo +0 -0
  730. data/vendor/local/share/locale/az/LC_MESSAGES/glib20.mo +0 -0
  731. data/vendor/local/share/locale/be/LC_MESSAGES/gettext-runtime.mo +0 -0
  732. data/vendor/local/share/locale/be/LC_MESSAGES/glib20.mo +0 -0
  733. data/vendor/local/share/locale/be@latin/LC_MESSAGES/glib20.mo +0 -0
  734. data/vendor/local/share/locale/bg/LC_MESSAGES/gettext-runtime.mo +0 -0
  735. data/vendor/local/share/locale/bg/LC_MESSAGES/glib20.mo +0 -0
  736. data/vendor/local/share/locale/bn/LC_MESSAGES/glib20.mo +0 -0
  737. data/vendor/local/share/locale/bn_IN/LC_MESSAGES/glib20.mo +0 -0
  738. data/vendor/local/share/locale/bs/LC_MESSAGES/glib20.mo +0 -0
  739. data/vendor/local/share/locale/ca/LC_MESSAGES/gettext-runtime.mo +0 -0
  740. data/vendor/local/share/locale/ca/LC_MESSAGES/glib20.mo +0 -0
  741. data/vendor/local/share/locale/ca@valencia/LC_MESSAGES/glib20.mo +0 -0
  742. data/vendor/local/share/locale/cs/LC_MESSAGES/gettext-runtime.mo +0 -0
  743. data/vendor/local/share/locale/cs/LC_MESSAGES/glib20.mo +0 -0
  744. data/vendor/local/share/locale/cy/LC_MESSAGES/glib20.mo +0 -0
  745. data/vendor/local/share/locale/da/LC_MESSAGES/gettext-runtime.mo +0 -0
  746. data/vendor/local/share/locale/da/LC_MESSAGES/glib20.mo +0 -0
  747. data/vendor/local/share/locale/de/LC_MESSAGES/gettext-runtime.mo +0 -0
  748. data/vendor/local/share/locale/de/LC_MESSAGES/glib20.mo +0 -0
  749. data/vendor/local/share/locale/dz/LC_MESSAGES/glib20.mo +0 -0
  750. data/vendor/local/share/locale/el/LC_MESSAGES/gettext-runtime.mo +0 -0
  751. data/vendor/local/share/locale/el/LC_MESSAGES/glib20.mo +0 -0
  752. data/vendor/local/share/locale/en@boldquot/LC_MESSAGES/gettext-runtime.mo +0 -0
  753. data/vendor/local/share/locale/en@quot/LC_MESSAGES/gettext-runtime.mo +0 -0
  754. data/vendor/local/share/locale/en@shaw/LC_MESSAGES/glib20.mo +0 -0
  755. data/vendor/local/share/locale/en_CA/LC_MESSAGES/glib20.mo +0 -0
  756. data/vendor/local/share/locale/en_GB/LC_MESSAGES/glib20.mo +0 -0
  757. data/vendor/local/share/locale/eo/LC_MESSAGES/gettext-runtime.mo +0 -0
  758. data/vendor/local/share/locale/eo/LC_MESSAGES/glib20.mo +0 -0
  759. data/vendor/local/share/locale/es/LC_MESSAGES/gettext-runtime.mo +0 -0
  760. data/vendor/local/share/locale/es/LC_MESSAGES/glib20.mo +0 -0
  761. data/vendor/local/share/locale/et/LC_MESSAGES/gettext-runtime.mo +0 -0
  762. data/vendor/local/share/locale/et/LC_MESSAGES/glib20.mo +0 -0
  763. data/vendor/local/share/locale/eu/LC_MESSAGES/glib20.mo +0 -0
  764. data/vendor/local/share/locale/fa/LC_MESSAGES/glib20.mo +0 -0
  765. data/vendor/local/share/locale/fi/LC_MESSAGES/gettext-runtime.mo +0 -0
  766. data/vendor/local/share/locale/fi/LC_MESSAGES/glib20.mo +0 -0
  767. data/vendor/local/share/locale/fr/LC_MESSAGES/gettext-runtime.mo +0 -0
  768. data/vendor/local/share/locale/fr/LC_MESSAGES/glib20.mo +0 -0
  769. data/vendor/local/share/locale/ga/LC_MESSAGES/gettext-runtime.mo +0 -0
  770. data/vendor/local/share/locale/ga/LC_MESSAGES/glib20.mo +0 -0
  771. data/vendor/local/share/locale/gl/LC_MESSAGES/gettext-runtime.mo +0 -0
  772. data/vendor/local/share/locale/gl/LC_MESSAGES/glib20.mo +0 -0
  773. data/vendor/local/share/locale/gu/LC_MESSAGES/glib20.mo +0 -0
  774. data/vendor/local/share/locale/he/LC_MESSAGES/glib20.mo +0 -0
  775. data/vendor/local/share/locale/hi/LC_MESSAGES/glib20.mo +0 -0
  776. data/vendor/local/share/locale/hr/LC_MESSAGES/glib20.mo +0 -0
  777. data/vendor/local/share/locale/hu/LC_MESSAGES/glib20.mo +0 -0
  778. data/vendor/local/share/locale/hy/LC_MESSAGES/glib20.mo +0 -0
  779. data/vendor/local/share/locale/id/LC_MESSAGES/gettext-runtime.mo +0 -0
  780. data/vendor/local/share/locale/id/LC_MESSAGES/glib20.mo +0 -0
  781. data/vendor/local/share/locale/is/LC_MESSAGES/glib20.mo +0 -0
  782. data/vendor/local/share/locale/it/LC_MESSAGES/gettext-runtime.mo +0 -0
  783. data/vendor/local/share/locale/it/LC_MESSAGES/glib20.mo +0 -0
  784. data/vendor/local/share/locale/ja/LC_MESSAGES/gettext-runtime.mo +0 -0
  785. data/vendor/local/share/locale/ja/LC_MESSAGES/glib20.mo +0 -0
  786. data/vendor/local/share/locale/ka/LC_MESSAGES/glib20.mo +0 -0
  787. data/vendor/local/share/locale/kn/LC_MESSAGES/glib20.mo +0 -0
  788. data/vendor/local/share/locale/ko/LC_MESSAGES/gettext-runtime.mo +0 -0
  789. data/vendor/local/share/locale/ko/LC_MESSAGES/glib20.mo +0 -0
  790. data/vendor/local/share/locale/ku/LC_MESSAGES/glib20.mo +0 -0
  791. data/vendor/local/share/locale/locale.alias +77 -0
  792. data/vendor/local/share/locale/lt/LC_MESSAGES/glib20.mo +0 -0
  793. data/vendor/local/share/locale/lv/LC_MESSAGES/glib20.mo +0 -0
  794. data/vendor/local/share/locale/mai/LC_MESSAGES/glib20.mo +0 -0
  795. data/vendor/local/share/locale/mg/LC_MESSAGES/glib20.mo +0 -0
  796. data/vendor/local/share/locale/mk/LC_MESSAGES/glib20.mo +0 -0
  797. data/vendor/local/share/locale/ml/LC_MESSAGES/glib20.mo +0 -0
  798. data/vendor/local/share/locale/mn/LC_MESSAGES/glib20.mo +0 -0
  799. data/vendor/local/share/locale/mr/LC_MESSAGES/glib20.mo +0 -0
  800. data/vendor/local/share/locale/ms/LC_MESSAGES/glib20.mo +0 -0
  801. data/vendor/local/share/locale/nb/LC_MESSAGES/gettext-runtime.mo +0 -0
  802. data/vendor/local/share/locale/nb/LC_MESSAGES/glib20.mo +0 -0
  803. data/vendor/local/share/locale/nds/LC_MESSAGES/glib20.mo +0 -0
  804. data/vendor/local/share/locale/ne/LC_MESSAGES/glib20.mo +0 -0
  805. data/vendor/local/share/locale/nl/LC_MESSAGES/gettext-runtime.mo +0 -0
  806. data/vendor/local/share/locale/nl/LC_MESSAGES/glib20.mo +0 -0
  807. data/vendor/local/share/locale/nn/LC_MESSAGES/gettext-runtime.mo +0 -0
  808. data/vendor/local/share/locale/nn/LC_MESSAGES/glib20.mo +0 -0
  809. data/vendor/local/share/locale/oc/LC_MESSAGES/glib20.mo +0 -0
  810. data/vendor/local/share/locale/or/LC_MESSAGES/glib20.mo +0 -0
  811. data/vendor/local/share/locale/pa/LC_MESSAGES/glib20.mo +0 -0
  812. data/vendor/local/share/locale/pl/LC_MESSAGES/gettext-runtime.mo +0 -0
  813. data/vendor/local/share/locale/pl/LC_MESSAGES/glib20.mo +0 -0
  814. data/vendor/local/share/locale/ps/LC_MESSAGES/glib20.mo +0 -0
  815. data/vendor/local/share/locale/pt/LC_MESSAGES/gettext-runtime.mo +0 -0
  816. data/vendor/local/share/locale/pt/LC_MESSAGES/glib20.mo +0 -0
  817. data/vendor/local/share/locale/pt_BR/LC_MESSAGES/gettext-runtime.mo +0 -0
  818. data/vendor/local/share/locale/pt_BR/LC_MESSAGES/glib20.mo +0 -0
  819. data/vendor/local/share/locale/ro/LC_MESSAGES/gettext-runtime.mo +0 -0
  820. data/vendor/local/share/locale/ro/LC_MESSAGES/glib20.mo +0 -0
  821. data/vendor/local/share/locale/ru/LC_MESSAGES/gettext-runtime.mo +0 -0
  822. data/vendor/local/share/locale/ru/LC_MESSAGES/glib20.mo +0 -0
  823. data/vendor/local/share/locale/rw/LC_MESSAGES/glib20.mo +0 -0
  824. data/vendor/local/share/locale/si/LC_MESSAGES/glib20.mo +0 -0
  825. data/vendor/local/share/locale/sk/LC_MESSAGES/gettext-runtime.mo +0 -0
  826. data/vendor/local/share/locale/sk/LC_MESSAGES/glib20.mo +0 -0
  827. data/vendor/local/share/locale/sl/LC_MESSAGES/gettext-runtime.mo +0 -0
  828. data/vendor/local/share/locale/sl/LC_MESSAGES/glib20.mo +0 -0
  829. data/vendor/local/share/locale/sq/LC_MESSAGES/glib20.mo +0 -0
  830. data/vendor/local/share/locale/sr/LC_MESSAGES/gettext-runtime.mo +0 -0
  831. data/vendor/local/share/locale/sr/LC_MESSAGES/glib20.mo +0 -0
  832. data/vendor/local/share/locale/sr@ije/LC_MESSAGES/glib20.mo +0 -0
  833. data/vendor/local/share/locale/sr@latin/LC_MESSAGES/glib20.mo +0 -0
  834. data/vendor/local/share/locale/sv/LC_MESSAGES/gettext-runtime.mo +0 -0
  835. data/vendor/local/share/locale/sv/LC_MESSAGES/glib20.mo +0 -0
  836. data/vendor/local/share/locale/ta/LC_MESSAGES/glib20.mo +0 -0
  837. data/vendor/local/share/locale/te/LC_MESSAGES/glib20.mo +0 -0
  838. data/vendor/local/share/locale/th/LC_MESSAGES/glib20.mo +0 -0
  839. data/vendor/local/share/locale/tl/LC_MESSAGES/glib20.mo +0 -0
  840. data/vendor/local/share/locale/tr/LC_MESSAGES/gettext-runtime.mo +0 -0
  841. data/vendor/local/share/locale/tr/LC_MESSAGES/glib20.mo +0 -0
  842. data/vendor/local/share/locale/tt/LC_MESSAGES/glib20.mo +0 -0
  843. data/vendor/local/share/locale/uk/LC_MESSAGES/gettext-runtime.mo +0 -0
  844. data/vendor/local/share/locale/uk/LC_MESSAGES/glib20.mo +0 -0
  845. data/vendor/local/share/locale/vi/LC_MESSAGES/gettext-runtime.mo +0 -0
  846. data/vendor/local/share/locale/vi/LC_MESSAGES/glib20.mo +0 -0
  847. data/vendor/local/share/locale/wa/LC_MESSAGES/glib20.mo +0 -0
  848. data/vendor/local/share/locale/xh/LC_MESSAGES/glib20.mo +0 -0
  849. data/vendor/local/share/locale/yi/LC_MESSAGES/glib20.mo +0 -0
  850. data/vendor/local/share/locale/zh_CN/LC_MESSAGES/gettext-runtime.mo +0 -0
  851. data/vendor/local/share/locale/zh_CN/LC_MESSAGES/glib20.mo +0 -0
  852. data/vendor/local/share/locale/zh_HK/LC_MESSAGES/gettext-runtime.mo +0 -0
  853. data/vendor/local/share/locale/zh_HK/LC_MESSAGES/glib20.mo +0 -0
  854. data/vendor/local/share/locale/zh_TW/LC_MESSAGES/gettext-runtime.mo +0 -0
  855. data/vendor/local/share/locale/zh_TW/LC_MESSAGES/glib20.mo +0 -0
  856. data/vendor/local/share/man/man1/envsubst.1 +54 -0
  857. data/vendor/local/share/man/man1/gettext.1 +69 -0
  858. data/vendor/local/share/man/man1/glib-genmarshal.1 +307 -0
  859. data/vendor/local/share/man/man1/glib-mkenums.1 +234 -0
  860. data/vendor/local/share/man/man1/gobject-query.1 +83 -0
  861. data/vendor/local/share/man/man1/ngettext.1 +68 -0
  862. data/vendor/local/share/man/man3/bind_textdomain_codeset.3 +72 -0
  863. data/vendor/local/share/man/man3/bindtextdomain.3 +69 -0
  864. data/vendor/local/share/man/man3/dcgettext.3 +1 -0
  865. data/vendor/local/share/man/man3/dcngettext.3 +1 -0
  866. data/vendor/local/share/man/man3/dgettext.3 +1 -0
  867. data/vendor/local/share/man/man3/dngettext.3 +1 -0
  868. data/vendor/local/share/man/man3/gettext.3 +99 -0
  869. data/vendor/local/share/man/man3/ngettext.3 +60 -0
  870. data/vendor/local/share/man/man3/textdomain.3 +57 -0
  871. data/vendor/local/src/tml/packaging/gettext_0.18.1.1-2_win32.log +10423 -0
  872. data/vendor/local/src/tml/packaging/gettext_0.18.1.1-2_win32.sh +457 -0
  873. data/vendor/local/src/tml/packaging/glib_2.24.2-2_win32.log +2602 -0
  874. data/vendor/local/src/tml/packaging/glib_2.24.2-2_win32.sh +290 -0
  875. metadata +940 -0
@@ -0,0 +1,3411 @@
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>Threads</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-core.html" title="GLib Core Application Support">
9
+ <link rel="prev" href="glib-The-Main-Event-Loop.html" title="The Main Event Loop">
10
+ <link rel="next" href="glib-Thread-Pools.html" title="Thread Pools">
11
+ <meta name="generator" content="GTK-Doc V1.14 (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-The-Main-Event-Loop.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18
+ <td><a accesskey="u" href="glib-core.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-Thread-Pools.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-Threads.synopsis" class="shortcut">Top</a>
25
+  | 
26
+ <a href="#glib-Threads.description" class="shortcut">Description</a>
27
+ </td></tr>
28
+ </table>
29
+ <div class="refentry" title="Threads">
30
+ <a name="glib-Threads"></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-Threads.top_of_page"></a>Threads</span></h2>
34
+ <p>Threads — thread abstraction; including threads, different
35
+ mutexes, conditions and thread private data</p>
36
+ </td>
37
+ <td valign="top" align="right"></td>
38
+ </tr></table></div>
39
+ <div class="refsynopsisdiv" title="Synopsis">
40
+ <a name="glib-Threads.synopsis"></a><h2>Synopsis</h2>
41
+ <pre class="synopsis">
42
+ #include &lt;glib.h&gt;
43
+
44
+ #define <a class="link" href="glib-Threads.html#G-THREADS-ENABLED:CAPS" title="G_THREADS_ENABLED">G_THREADS_ENABLED</a>
45
+ #define <a class="link" href="glib-Threads.html#G-THREADS-IMPL-POSIX:CAPS" title="G_THREADS_IMPL_POSIX">G_THREADS_IMPL_POSIX</a>
46
+ #define <a class="link" href="glib-Threads.html#G-THREADS-IMPL-NONE:CAPS" title="G_THREADS_IMPL_NONE">G_THREADS_IMPL_NONE</a>
47
+
48
+ #define <a class="link" href="glib-Threads.html#G-THREAD-ERROR:CAPS" title="G_THREAD_ERROR">G_THREAD_ERROR</a>
49
+ enum <a class="link" href="glib-Threads.html#GThreadError" title="enum GThreadError">GThreadError</a>;
50
+
51
+ <a class="link" href="glib-Threads.html#GThreadFunctions" title="GThreadFunctions">GThreadFunctions</a>;
52
+ <span class="returnvalue">void</span> <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()">g_thread_init</a> (<em class="parameter"><code><a class="link" href="glib-Threads.html#GThreadFunctions" title="GThreadFunctions"><span class="type">GThreadFunctions</span></a> *vtable</code></em>);
53
+ <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Threads.html#g-thread-supported" title="g_thread_supported ()">g_thread_supported</a> ();
54
+ <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Threads.html#g-thread-get-initialized" title="g_thread_get_initialized ()">g_thread_get_initialized</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
55
+
56
+ <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a> (<a class="link" href="glib-Threads.html#GThreadFunc" title="GThreadFunc ()">*GThreadFunc</a>) (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> data</code></em>);
57
+ enum <a class="link" href="glib-Threads.html#GThreadPriority" title="enum GThreadPriority">GThreadPriority</a>;
58
+ <a class="link" href="glib-Threads.html#GThread" title="GThread">GThread</a>;
59
+ <a class="link" href="glib-Threads.html#GThread" title="GThread"><span class="returnvalue">GThread</span></a> * <a class="link" href="glib-Threads.html#g-thread-create" title="g_thread_create ()">g_thread_create</a> (<em class="parameter"><code><a class="link" href="glib-Threads.html#GThreadFunc" title="GThreadFunc ()"><span class="type">GThreadFunc</span></a> func</code></em>,
60
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> data</code></em>,
61
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="type">gboolean</span></a> joinable</code></em>,
62
+ <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);
63
+ <a class="link" href="glib-Threads.html#GThread" title="GThread"><span class="returnvalue">GThread</span></a>* <a class="link" href="glib-Threads.html#g-thread-create-full" title="g_thread_create_full ()">g_thread_create_full</a> (<em class="parameter"><code><a class="link" href="glib-Threads.html#GThreadFunc" title="GThreadFunc ()"><span class="type">GThreadFunc</span></a> func</code></em>,
64
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> data</code></em>,
65
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gulong" title="gulong"><span class="type">gulong</span></a> stack_size</code></em>,
66
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="type">gboolean</span></a> joinable</code></em>,
67
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="type">gboolean</span></a> bound</code></em>,
68
+ <em class="parameter"><code><a class="link" href="glib-Threads.html#GThreadPriority" title="enum GThreadPriority"><span class="type">GThreadPriority</span></a> priority</code></em>,
69
+ <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);
70
+ <a class="link" href="glib-Threads.html#GThread" title="GThread"><span class="returnvalue">GThread</span></a>* <a class="link" href="glib-Threads.html#g-thread-self" title="g_thread_self ()">g_thread_self</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
71
+ <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a> <a class="link" href="glib-Threads.html#g-thread-join" title="g_thread_join ()">g_thread_join</a> (<em class="parameter"><code><a class="link" href="glib-Threads.html#GThread" title="GThread"><span class="type">GThread</span></a> *thread</code></em>);
72
+ <span class="returnvalue">void</span> <a class="link" href="glib-Threads.html#g-thread-set-priority" title="g_thread_set_priority ()">g_thread_set_priority</a> (<em class="parameter"><code><a class="link" href="glib-Threads.html#GThread" title="GThread"><span class="type">GThread</span></a> *thread</code></em>,
73
+ <em class="parameter"><code><a class="link" href="glib-Threads.html#GThreadPriority" title="enum GThreadPriority"><span class="type">GThreadPriority</span></a> priority</code></em>);
74
+ <span class="returnvalue">void</span> <a class="link" href="glib-Threads.html#g-thread-yield" title="g_thread_yield ()">g_thread_yield</a> ();
75
+ <span class="returnvalue">void</span> <a class="link" href="glib-Threads.html#g-thread-exit" title="g_thread_exit ()">g_thread_exit</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> retval</code></em>);
76
+ <span class="returnvalue">void</span> <a class="link" href="glib-Threads.html#g-thread-foreach" title="g_thread_foreach ()">g_thread_foreach</a> (<em class="parameter"><code><a class="link" href="glib-Doubly-Linked-Lists.html#GFunc" title="GFunc ()"><span class="type">GFunc</span></a> thread_func</code></em>,
77
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
78
+
79
+ <a class="link" href="glib-Threads.html#GMutex" title="GMutex">GMutex</a>;
80
+ <a class="link" href="glib-Threads.html#GMutex" title="GMutex"><span class="returnvalue">GMutex</span></a> * <a class="link" href="glib-Threads.html#g-mutex-new" title="g_mutex_new ()">g_mutex_new</a> ();
81
+ <span class="returnvalue">void</span> <a class="link" href="glib-Threads.html#g-mutex-lock" title="g_mutex_lock ()">g_mutex_lock</a> (<em class="parameter"><code><a class="link" href="glib-Threads.html#GMutex" title="GMutex"><span class="type">GMutex</span></a> *mutex</code></em>);
82
+ <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Threads.html#g-mutex-trylock" title="g_mutex_trylock ()">g_mutex_trylock</a> (<em class="parameter"><code><a class="link" href="glib-Threads.html#GMutex" title="GMutex"><span class="type">GMutex</span></a> *mutex</code></em>);
83
+ <span class="returnvalue">void</span> <a class="link" href="glib-Threads.html#g-mutex-unlock" title="g_mutex_unlock ()">g_mutex_unlock</a> (<em class="parameter"><code><a class="link" href="glib-Threads.html#GMutex" title="GMutex"><span class="type">GMutex</span></a> *mutex</code></em>);
84
+ <span class="returnvalue">void</span> <a class="link" href="glib-Threads.html#g-mutex-free" title="g_mutex_free ()">g_mutex_free</a> (<em class="parameter"><code><a class="link" href="glib-Threads.html#GMutex" title="GMutex"><span class="type">GMutex</span></a> *mutex</code></em>);
85
+
86
+ <a class="link" href="glib-Threads.html#GStaticMutex" title="GStaticMutex">GStaticMutex</a>;
87
+ #define <a class="link" href="glib-Threads.html#G-STATIC-MUTEX-INIT:CAPS" title="G_STATIC_MUTEX_INIT">G_STATIC_MUTEX_INIT</a>
88
+ <span class="returnvalue">void</span> <a class="link" href="glib-Threads.html#g-static-mutex-init" title="g_static_mutex_init ()">g_static_mutex_init</a> (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a> *mutex</code></em>);
89
+ <span class="returnvalue">void</span> <a class="link" href="glib-Threads.html#g-static-mutex-lock" title="g_static_mutex_lock ()">g_static_mutex_lock</a> (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a> *mutex</code></em>);
90
+ <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Threads.html#g-static-mutex-trylock" title="g_static_mutex_trylock ()">g_static_mutex_trylock</a> (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a> *mutex</code></em>);
91
+ <span class="returnvalue">void</span> <a class="link" href="glib-Threads.html#g-static-mutex-unlock" title="g_static_mutex_unlock ()">g_static_mutex_unlock</a> (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a> *mutex</code></em>);
92
+ <a class="link" href="glib-Threads.html#GMutex" title="GMutex"><span class="returnvalue">GMutex</span></a> * <a class="link" href="glib-Threads.html#g-static-mutex-get-mutex" title="g_static_mutex_get_mutex ()">g_static_mutex_get_mutex</a> (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a> *mutex</code></em>);
93
+ <span class="returnvalue">void</span> <a class="link" href="glib-Threads.html#g-static-mutex-free" title="g_static_mutex_free ()">g_static_mutex_free</a> (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a> *mutex</code></em>);
94
+
95
+ #define <a class="link" href="glib-Threads.html#G-LOCK-DEFINE:CAPS" title="G_LOCK_DEFINE()">G_LOCK_DEFINE</a> (name)
96
+ #define <a class="link" href="glib-Threads.html#G-LOCK-DEFINE-STATIC:CAPS" title="G_LOCK_DEFINE_STATIC()">G_LOCK_DEFINE_STATIC</a> (name)
97
+ #define <a class="link" href="glib-Threads.html#G-LOCK-EXTERN:CAPS" title="G_LOCK_EXTERN()">G_LOCK_EXTERN</a> (name)
98
+ #define <a class="link" href="glib-Threads.html#G-LOCK:CAPS" title="G_LOCK()">G_LOCK</a> (name)
99
+ #define <a class="link" href="glib-Threads.html#G-TRYLOCK:CAPS" title="G_TRYLOCK()">G_TRYLOCK</a> (name)
100
+ #define <a class="link" href="glib-Threads.html#G-UNLOCK:CAPS" title="G_UNLOCK()">G_UNLOCK</a> (name)
101
+
102
+ <a class="link" href="glib-Threads.html#GStaticRecMutex" title="GStaticRecMutex">GStaticRecMutex</a>;
103
+ #define <a class="link" href="glib-Threads.html#G-STATIC-REC-MUTEX-INIT:CAPS" title="G_STATIC_REC_MUTEX_INIT">G_STATIC_REC_MUTEX_INIT</a>
104
+ <span class="returnvalue">void</span> <a class="link" href="glib-Threads.html#g-static-rec-mutex-init" title="g_static_rec_mutex_init ()">g_static_rec_mutex_init</a> (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticRecMutex" title="GStaticRecMutex"><span class="type">GStaticRecMutex</span></a> *mutex</code></em>);
105
+ <span class="returnvalue">void</span> <a class="link" href="glib-Threads.html#g-static-rec-mutex-lock" title="g_static_rec_mutex_lock ()">g_static_rec_mutex_lock</a> (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticRecMutex" title="GStaticRecMutex"><span class="type">GStaticRecMutex</span></a> *mutex</code></em>);
106
+ <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Threads.html#g-static-rec-mutex-trylock" title="g_static_rec_mutex_trylock ()">g_static_rec_mutex_trylock</a> (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticRecMutex" title="GStaticRecMutex"><span class="type">GStaticRecMutex</span></a> *mutex</code></em>);
107
+ <span class="returnvalue">void</span> <a class="link" href="glib-Threads.html#g-static-rec-mutex-unlock" title="g_static_rec_mutex_unlock ()">g_static_rec_mutex_unlock</a> (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticRecMutex" title="GStaticRecMutex"><span class="type">GStaticRecMutex</span></a> *mutex</code></em>);
108
+ <span class="returnvalue">void</span> <a class="link" href="glib-Threads.html#g-static-rec-mutex-lock-full" title="g_static_rec_mutex_lock_full ()">g_static_rec_mutex_lock_full</a> (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticRecMutex" title="GStaticRecMutex"><span class="type">GStaticRecMutex</span></a> *mutex</code></em>,
109
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="type">guint</span></a> depth</code></em>);
110
+ <a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="returnvalue">guint</span></a> <a class="link" href="glib-Threads.html#g-static-rec-mutex-unlock-full" title="g_static_rec_mutex_unlock_full ()">g_static_rec_mutex_unlock_full</a> (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticRecMutex" title="GStaticRecMutex"><span class="type">GStaticRecMutex</span></a> *mutex</code></em>);
111
+ <span class="returnvalue">void</span> <a class="link" href="glib-Threads.html#g-static-rec-mutex-free" title="g_static_rec_mutex_free ()">g_static_rec_mutex_free</a> (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticRecMutex" title="GStaticRecMutex"><span class="type">GStaticRecMutex</span></a> *mutex</code></em>);
112
+
113
+ <a class="link" href="glib-Threads.html#GStaticRWLock" title="GStaticRWLock">GStaticRWLock</a>;
114
+ #define <a class="link" href="glib-Threads.html#G-STATIC-RW-LOCK-INIT:CAPS" title="G_STATIC_RW_LOCK_INIT">G_STATIC_RW_LOCK_INIT</a>
115
+ <span class="returnvalue">void</span> <a class="link" href="glib-Threads.html#g-static-rw-lock-init" title="g_static_rw_lock_init ()">g_static_rw_lock_init</a> (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticRWLock" title="GStaticRWLock"><span class="type">GStaticRWLock</span></a> *lock</code></em>);
116
+ <span class="returnvalue">void</span> <a class="link" href="glib-Threads.html#g-static-rw-lock-reader-lock" title="g_static_rw_lock_reader_lock ()">g_static_rw_lock_reader_lock</a> (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticRWLock" title="GStaticRWLock"><span class="type">GStaticRWLock</span></a> *lock</code></em>);
117
+ <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Threads.html#g-static-rw-lock-reader-trylock" title="g_static_rw_lock_reader_trylock ()">g_static_rw_lock_reader_trylock</a> (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticRWLock" title="GStaticRWLock"><span class="type">GStaticRWLock</span></a> *lock</code></em>);
118
+ <span class="returnvalue">void</span> <a class="link" href="glib-Threads.html#g-static-rw-lock-reader-unlock" title="g_static_rw_lock_reader_unlock ()">g_static_rw_lock_reader_unlock</a> (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticRWLock" title="GStaticRWLock"><span class="type">GStaticRWLock</span></a> *lock</code></em>);
119
+ <span class="returnvalue">void</span> <a class="link" href="glib-Threads.html#g-static-rw-lock-writer-lock" title="g_static_rw_lock_writer_lock ()">g_static_rw_lock_writer_lock</a> (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticRWLock" title="GStaticRWLock"><span class="type">GStaticRWLock</span></a> *lock</code></em>);
120
+ <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Threads.html#g-static-rw-lock-writer-trylock" title="g_static_rw_lock_writer_trylock ()">g_static_rw_lock_writer_trylock</a> (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticRWLock" title="GStaticRWLock"><span class="type">GStaticRWLock</span></a> *lock</code></em>);
121
+ <span class="returnvalue">void</span> <a class="link" href="glib-Threads.html#g-static-rw-lock-writer-unlock" title="g_static_rw_lock_writer_unlock ()">g_static_rw_lock_writer_unlock</a> (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticRWLock" title="GStaticRWLock"><span class="type">GStaticRWLock</span></a> *lock</code></em>);
122
+ <span class="returnvalue">void</span> <a class="link" href="glib-Threads.html#g-static-rw-lock-free" title="g_static_rw_lock_free ()">g_static_rw_lock_free</a> (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticRWLock" title="GStaticRWLock"><span class="type">GStaticRWLock</span></a> *lock</code></em>);
123
+
124
+ <a class="link" href="glib-Threads.html#GCond" title="GCond">GCond</a>;
125
+ <a class="link" href="glib-Threads.html#GCond" title="GCond"><span class="returnvalue">GCond</span></a>* <a class="link" href="glib-Threads.html#g-cond-new" title="g_cond_new ()">g_cond_new</a> ();
126
+ <span class="returnvalue">void</span> <a class="link" href="glib-Threads.html#g-cond-signal" title="g_cond_signal ()">g_cond_signal</a> (<em class="parameter"><code><a class="link" href="glib-Threads.html#GCond" title="GCond"><span class="type">GCond</span></a> *cond</code></em>);
127
+ <span class="returnvalue">void</span> <a class="link" href="glib-Threads.html#g-cond-broadcast" title="g_cond_broadcast ()">g_cond_broadcast</a> (<em class="parameter"><code><a class="link" href="glib-Threads.html#GCond" title="GCond"><span class="type">GCond</span></a> *cond</code></em>);
128
+ <span class="returnvalue">void</span> <a class="link" href="glib-Threads.html#g-cond-wait" title="g_cond_wait ()">g_cond_wait</a> (<em class="parameter"><code><a class="link" href="glib-Threads.html#GCond" title="GCond"><span class="type">GCond</span></a> *cond</code></em>,
129
+ <em class="parameter"><code><a class="link" href="glib-Threads.html#GMutex" title="GMutex"><span class="type">GMutex</span></a> *mutex</code></em>);
130
+ <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Threads.html#g-cond-timed-wait" title="g_cond_timed_wait ()">g_cond_timed_wait</a> (<em class="parameter"><code><a class="link" href="glib-Threads.html#GCond" title="GCond"><span class="type">GCond</span></a> *cond</code></em>,
131
+ <em class="parameter"><code><a class="link" href="glib-Threads.html#GMutex" title="GMutex"><span class="type">GMutex</span></a> *mutex</code></em>,
132
+ <em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal"><span class="type">GTimeVal</span></a> *abs_time</code></em>);
133
+ <span class="returnvalue">void</span> <a class="link" href="glib-Threads.html#g-cond-free" title="g_cond_free ()">g_cond_free</a> (<em class="parameter"><code><a class="link" href="glib-Threads.html#GCond" title="GCond"><span class="type">GCond</span></a> *cond</code></em>);
134
+
135
+ <a class="link" href="glib-Threads.html#GPrivate" title="GPrivate">GPrivate</a>;
136
+ <a class="link" href="glib-Threads.html#GPrivate" title="GPrivate"><span class="returnvalue">GPrivate</span></a>* <a class="link" href="glib-Threads.html#g-private-new" title="g_private_new ()">g_private_new</a> (<em class="parameter"><code><a class="link" href="glib-Datasets.html#GDestroyNotify" title="GDestroyNotify ()"><span class="type">GDestroyNotify</span></a> destructor</code></em>);
137
+ <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a> <a class="link" href="glib-Threads.html#g-private-get" title="g_private_get ()">g_private_get</a> (<em class="parameter"><code><a class="link" href="glib-Threads.html#GPrivate" title="GPrivate"><span class="type">GPrivate</span></a> *private_key</code></em>);
138
+ <span class="returnvalue">void</span> <a class="link" href="glib-Threads.html#g-private-set" title="g_private_set ()">g_private_set</a> (<em class="parameter"><code><a class="link" href="glib-Threads.html#GPrivate" title="GPrivate"><span class="type">GPrivate</span></a> *private_key</code></em>,
139
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> data</code></em>);
140
+
141
+ <a class="link" href="glib-Threads.html#GStaticPrivate" title="GStaticPrivate">GStaticPrivate</a>;
142
+ #define <a class="link" href="glib-Threads.html#G-STATIC-PRIVATE-INIT:CAPS" title="G_STATIC_PRIVATE_INIT">G_STATIC_PRIVATE_INIT</a>
143
+ <span class="returnvalue">void</span> <a class="link" href="glib-Threads.html#g-static-private-init" title="g_static_private_init ()">g_static_private_init</a> (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticPrivate" title="GStaticPrivate"><span class="type">GStaticPrivate</span></a> *private_key</code></em>);
144
+ <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a> <a class="link" href="glib-Threads.html#g-static-private-get" title="g_static_private_get ()">g_static_private_get</a> (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticPrivate" title="GStaticPrivate"><span class="type">GStaticPrivate</span></a> *private_key</code></em>);
145
+ <span class="returnvalue">void</span> <a class="link" href="glib-Threads.html#g-static-private-set" title="g_static_private_set ()">g_static_private_set</a> (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticPrivate" title="GStaticPrivate"><span class="type">GStaticPrivate</span></a> *private_key</code></em>,
146
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> data</code></em>,
147
+ <em class="parameter"><code><a class="link" href="glib-Datasets.html#GDestroyNotify" title="GDestroyNotify ()"><span class="type">GDestroyNotify</span></a> notify</code></em>);
148
+ <span class="returnvalue">void</span> <a class="link" href="glib-Threads.html#g-static-private-free" title="g_static_private_free ()">g_static_private_free</a> (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticPrivate" title="GStaticPrivate"><span class="type">GStaticPrivate</span></a> *private_key</code></em>);
149
+
150
+ <a class="link" href="glib-Threads.html#GOnce" title="GOnce">GOnce</a>;
151
+ enum <a class="link" href="glib-Threads.html#GOnceStatus" title="enum GOnceStatus">GOnceStatus</a>;
152
+ #define <a class="link" href="glib-Threads.html#G-ONCE-INIT:CAPS" title="G_ONCE_INIT">G_ONCE_INIT</a>
153
+ #define <a class="link" href="glib-Threads.html#g-once" title="g_once()">g_once</a> (once,
154
+ func,
155
+ arg)
156
+ <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Threads.html#g-once-init-enter" title="g_once_init_enter ()">g_once_init_enter</a> (<em class="parameter"><code>volatile <a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *value_location</code></em>);
157
+ <span class="returnvalue">void</span> <a class="link" href="glib-Threads.html#g-once-init-leave" title="g_once_init_leave ()">g_once_init_leave</a> (<em class="parameter"><code>volatile <a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *value_location</code></em>,
158
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> initialization_value</code></em>);
159
+
160
+ <span class="returnvalue">void</span> <a class="link" href="glib-Threads.html#g-bit-lock" title="g_bit_lock ()">g_bit_lock</a> (<em class="parameter"><code>volatile <a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> *address</code></em>,
161
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> lock_bit</code></em>);
162
+ <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Threads.html#g-bit-trylock" title="g_bit_trylock ()">g_bit_trylock</a> (<em class="parameter"><code>volatile <a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> *address</code></em>,
163
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> lock_bit</code></em>);
164
+ <span class="returnvalue">void</span> <a class="link" href="glib-Threads.html#g-bit-unlock" title="g_bit_unlock ()">g_bit_unlock</a> (<em class="parameter"><code>volatile <a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> *address</code></em>,
165
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> lock_bit</code></em>);
166
+ </pre>
167
+ </div>
168
+ <div class="refsect1" title="Description">
169
+ <a name="glib-Threads.description"></a><h2>Description</h2>
170
+ <p>
171
+ Threads act almost like processes, but unlike processes all threads
172
+ of one process share the same memory. This is good, as it provides
173
+ easy communication between the involved threads via this shared
174
+ memory, and it is bad, because strange things (so called
175
+ "Heisenbugs") might happen if the program is not carefully designed.
176
+ In particular, due to the concurrent nature of threads, no
177
+ assumptions on the order of execution of code running in different
178
+ threads can be made, unless order is explicitly forced by the
179
+ programmer through synchronization primitives.
180
+ </p>
181
+ <p>
182
+ The aim of the thread related functions in GLib is to provide a
183
+ portable means for writing multi-threaded software. There are
184
+ primitives for mutexes to protect the access to portions of memory
185
+ (<a class="link" href="glib-Threads.html#GMutex" title="GMutex"><span class="type">GMutex</span></a>, <a class="link" href="glib-Threads.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a>, <a class="link" href="glib-Threads.html#G-LOCK-DEFINE:CAPS" title="G_LOCK_DEFINE()"><span class="type">G_LOCK_DEFINE</span></a>, <a class="link" href="glib-Threads.html#GStaticRecMutex" title="GStaticRecMutex"><span class="type">GStaticRecMutex</span></a> and
186
+ <a class="link" href="glib-Threads.html#GStaticRWLock" title="GStaticRWLock"><span class="type">GStaticRWLock</span></a>). There are primitives for condition variables to
187
+ allow synchronization of threads (<a class="link" href="glib-Threads.html#GCond" title="GCond"><span class="type">GCond</span></a>). There are primitives for
188
+ thread-private data - data that every thread has a private instance
189
+ of (<a class="link" href="glib-Threads.html#GPrivate" title="GPrivate"><span class="type">GPrivate</span></a>, <a class="link" href="glib-Threads.html#GStaticPrivate" title="GStaticPrivate"><span class="type">GStaticPrivate</span></a>). Last but definitely not least there
190
+ are primitives to portably create and manage threads (<a class="link" href="glib-Threads.html#GThread" title="GThread"><span class="type">GThread</span></a>).
191
+ </p>
192
+ <p>
193
+ The threading system is initialized with <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a>, which
194
+ takes an optional custom thread implementation or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> for the
195
+ default implementation. If you want to call <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a> with a
196
+ non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> argument this must be done before executing any other GLib
197
+ functions (except <a class="link" href="glib-Memory-Allocation.html#g-mem-set-vtable" title="g_mem_set_vtable ()"><code class="function">g_mem_set_vtable()</code></a>). This is a requirement even if
198
+ no threads are in fact ever created by the process.
199
+ </p>
200
+ <p>
201
+ Calling <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a> with a <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> argument is somewhat more
202
+ relaxed. You may call any other glib functions in the main thread
203
+ before <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a> as long as <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a> is not called from
204
+ a glib callback, or with any locks held. However, many libraries
205
+ above glib does not support late initialization of threads, so doing
206
+ this should be avoided if possible.
207
+ </p>
208
+ <p>
209
+ Please note that since version 2.24 the GObject initialization
210
+ function <a href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#g-type-init"><code class="function">g_type_init()</code></a> initializes threads (with a <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> argument),
211
+ so most applications, including those using Gtk+ will run with
212
+ threads enabled. If you want a special thread implementation, make
213
+ sure you call <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a> before <a href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#g-type-init"><code class="function">g_type_init()</code></a> is called.
214
+ </p>
215
+ <p>
216
+ After calling <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a>, GLib is completely thread safe (all
217
+ global data is automatically locked), but individual data structure
218
+ instances are not automatically locked for performance reasons. So,
219
+ for example you must coordinate accesses to the same <a class="link" href="glib-Hash-Tables.html#GHashTable" title="GHashTable"><span class="type">GHashTable</span></a>
220
+ from multiple threads. The two notable exceptions from this rule
221
+ are <a class="link" href="glib-The-Main-Event-Loop.html#GMainLoop" title="GMainLoop"><span class="type">GMainLoop</span></a> and <a class="link" href="glib-Asynchronous-Queues.html#GAsyncQueue" title="GAsyncQueue"><span class="type">GAsyncQueue</span></a>, which <span class="emphasis"><em>are</em></span>
222
+ threadsafe and need no further application-level locking to be
223
+ accessed from multiple threads.
224
+ </p>
225
+ <p>
226
+ To help debugging problems in multithreaded applications, GLib
227
+ supports error-checking mutexes that will give you helpful error
228
+ messages on common problems. To use error-checking mutexes, define
229
+ the symbol <span class="type">G_ERRORCHECK_MUTEXES</span> when compiling the application.
230
+ </p>
231
+ </div>
232
+ <div class="refsect1" title="Details">
233
+ <a name="glib-Threads.details"></a><h2>Details</h2>
234
+ <div class="refsect2" title="G_THREADS_ENABLED">
235
+ <a name="G-THREADS-ENABLED:CAPS"></a><h3>G_THREADS_ENABLED</h3>
236
+ <pre class="programlisting">#define G_THREADS_ENABLED
237
+ </pre>
238
+ <p>
239
+ This macro is defined if GLib was compiled with thread support. This
240
+ does not necessarily mean that there is a thread implementation
241
+ available, but it does mean that the infrastructure is in place and
242
+ that once you provide a thread implementation to <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a>,
243
+ GLib will be multi-thread safe. If <a class="link" href="glib-Threads.html#G-THREADS-ENABLED:CAPS" title="G_THREADS_ENABLED"><span class="type">G_THREADS_ENABLED</span></a> is not
244
+ defined, then Glib is not, and cannot be, multi-thread safe.
245
+ </p>
246
+ </div>
247
+ <hr>
248
+ <div class="refsect2" title="G_THREADS_IMPL_POSIX">
249
+ <a name="G-THREADS-IMPL-POSIX:CAPS"></a><h3>G_THREADS_IMPL_POSIX</h3>
250
+ <pre class="programlisting">#define G_THREADS_IMPL_POSIX
251
+ </pre>
252
+ <p>
253
+ This macro is defined if POSIX style threads are used.
254
+ </p>
255
+ </div>
256
+ <hr>
257
+ <div class="refsect2" title="G_THREADS_IMPL_NONE">
258
+ <a name="G-THREADS-IMPL-NONE:CAPS"></a><h3>G_THREADS_IMPL_NONE</h3>
259
+ <pre class="programlisting">#define G_THREADS_IMPL_NONE
260
+ </pre>
261
+ <p>
262
+ This macro is defined if no thread implementation is used. You can,
263
+ however, provide one to <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a> to make GLib multi-thread
264
+ safe.
265
+ </p>
266
+ </div>
267
+ <hr>
268
+ <div class="refsect2" title="G_THREAD_ERROR">
269
+ <a name="G-THREAD-ERROR:CAPS"></a><h3>G_THREAD_ERROR</h3>
270
+ <pre class="programlisting">#define G_THREAD_ERROR g_thread_error_quark ()
271
+ </pre>
272
+ <p>
273
+ The error domain of the GLib thread subsystem.
274
+ </p>
275
+ </div>
276
+ <hr>
277
+ <div class="refsect2" title="enum GThreadError">
278
+ <a name="GThreadError"></a><h3>enum GThreadError</h3>
279
+ <pre class="programlisting">typedef enum
280
+ {
281
+ G_THREAD_ERROR_AGAIN /* Resource temporarily unavailable */
282
+ } GThreadError;
283
+ </pre>
284
+ <p>
285
+ Possible errors of thread related functions.
286
+ </p>
287
+ <div class="variablelist"><table border="0">
288
+ <col align="left" valign="top">
289
+ <tbody><tr>
290
+ <td><p><a name="G-THREAD-ERROR-AGAIN:CAPS"></a><span class="term"><code class="literal">G_THREAD_ERROR_AGAIN</code></span></p></td>
291
+ <td>a thread couldn't be created due to resource
292
+ shortage. Try again later.
293
+ </td>
294
+ </tr></tbody>
295
+ </table></div>
296
+ </div>
297
+ <hr>
298
+ <div class="refsect2" title="GThreadFunctions">
299
+ <a name="GThreadFunctions"></a><h3>GThreadFunctions</h3>
300
+ <pre class="programlisting">typedef struct {
301
+ GMutex* (*mutex_new) (void);
302
+ void (*mutex_lock) (GMutex *mutex);
303
+ gboolean (*mutex_trylock) (GMutex *mutex);
304
+ void (*mutex_unlock) (GMutex *mutex);
305
+ void (*mutex_free) (GMutex *mutex);
306
+ GCond* (*cond_new) (void);
307
+ void (*cond_signal) (GCond *cond);
308
+ void (*cond_broadcast) (GCond *cond);
309
+ void (*cond_wait) (GCond *cond,
310
+ GMutex *mutex);
311
+ gboolean (*cond_timed_wait) (GCond *cond,
312
+ GMutex *mutex,
313
+ GTimeVal *end_time);
314
+ void (*cond_free) (GCond *cond);
315
+ GPrivate* (*private_new) (GDestroyNotify destructor);
316
+ gpointer (*private_get) (GPrivate *private_key);
317
+ void (*private_set) (GPrivate *private_key,
318
+ gpointer data);
319
+ void (*thread_create) (GThreadFunc func,
320
+ gpointer data,
321
+ gulong stack_size,
322
+ gboolean joinable,
323
+ gboolean bound,
324
+ GThreadPriority priority,
325
+ gpointer thread,
326
+ GError **error);
327
+ void (*thread_yield) (void);
328
+ void (*thread_join) (gpointer thread);
329
+ void (*thread_exit) (void);
330
+ void (*thread_set_priority)(gpointer thread,
331
+ GThreadPriority priority);
332
+ void (*thread_self) (gpointer thread);
333
+ gboolean (*thread_equal) (gpointer thread1,
334
+ gpointer thread2);
335
+ } GThreadFunctions;
336
+ </pre>
337
+ <p>
338
+ This function table is used by <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a> to initialize the
339
+ thread system. The functions in the table are directly used by their
340
+ g_* prepended counterparts (described in this document). For
341
+ example, if you call <a class="link" href="glib-Threads.html#g-mutex-new" title="g_mutex_new ()"><code class="function">g_mutex_new()</code></a> then <code class="function">mutex_new()</code> from the table
342
+ provided to <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a> will be called.
343
+ </p>
344
+ <p>
345
+ </p>
346
+ <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
347
+ <h3 class="title">Note</h3>
348
+ <p>Do not use this struct unless you know what you are
349
+ doing.</p>
350
+ </div>
351
+ <p>
352
+ </p>
353
+ <div class="variablelist"><table border="0">
354
+ <col align="left" valign="top">
355
+ <tbody>
356
+ <tr>
357
+ <td><p><span class="term"><em class="structfield"><code><a name="GThreadFunctions.mutex-new"></a>mutex_new</code></em> ()</span></p></td>
358
+ <td>virtual function pointer for <a class="link" href="glib-Threads.html#g-mutex-new" title="g_mutex_new ()"><code class="function">g_mutex_new()</code></a>
359
+ </td>
360
+ </tr>
361
+ <tr>
362
+ <td><p><span class="term"><em class="structfield"><code><a name="GThreadFunctions.mutex-lock"></a>mutex_lock</code></em> ()</span></p></td>
363
+ <td>virtual function pointer for <a class="link" href="glib-Threads.html#g-mutex-lock" title="g_mutex_lock ()"><code class="function">g_mutex_lock()</code></a>
364
+ </td>
365
+ </tr>
366
+ <tr>
367
+ <td><p><span class="term"><em class="structfield"><code><a name="GThreadFunctions.mutex-trylock"></a>mutex_trylock</code></em> ()</span></p></td>
368
+ <td>virtual function pointer for <a class="link" href="glib-Threads.html#g-mutex-trylock" title="g_mutex_trylock ()"><code class="function">g_mutex_trylock()</code></a>
369
+ </td>
370
+ </tr>
371
+ <tr>
372
+ <td><p><span class="term"><em class="structfield"><code><a name="GThreadFunctions.mutex-unlock"></a>mutex_unlock</code></em> ()</span></p></td>
373
+ <td>virtual function pointer for <a class="link" href="glib-Threads.html#g-mutex-unlock" title="g_mutex_unlock ()"><code class="function">g_mutex_unlock()</code></a>
374
+ </td>
375
+ </tr>
376
+ <tr>
377
+ <td><p><span class="term"><em class="structfield"><code><a name="GThreadFunctions.mutex-free"></a>mutex_free</code></em> ()</span></p></td>
378
+ <td>virtual function pointer for <a class="link" href="glib-Threads.html#g-mutex-free" title="g_mutex_free ()"><code class="function">g_mutex_free()</code></a>
379
+ </td>
380
+ </tr>
381
+ <tr>
382
+ <td><p><span class="term"><em class="structfield"><code><a name="GThreadFunctions.cond-new"></a>cond_new</code></em> ()</span></p></td>
383
+ <td>virtual function pointer for <a class="link" href="glib-Threads.html#g-cond-new" title="g_cond_new ()"><code class="function">g_cond_new()</code></a>
384
+ </td>
385
+ </tr>
386
+ <tr>
387
+ <td><p><span class="term"><em class="structfield"><code><a name="GThreadFunctions.cond-signal"></a>cond_signal</code></em> ()</span></p></td>
388
+ <td>virtual function pointer for <a class="link" href="glib-Threads.html#g-cond-signal" title="g_cond_signal ()"><code class="function">g_cond_signal()</code></a>
389
+ </td>
390
+ </tr>
391
+ <tr>
392
+ <td><p><span class="term"><em class="structfield"><code><a name="GThreadFunctions.cond-broadcast"></a>cond_broadcast</code></em> ()</span></p></td>
393
+ <td>virtual function pointer for <a class="link" href="glib-Threads.html#g-cond-broadcast" title="g_cond_broadcast ()"><code class="function">g_cond_broadcast()</code></a>
394
+ </td>
395
+ </tr>
396
+ <tr>
397
+ <td><p><span class="term"><em class="structfield"><code><a name="GThreadFunctions.cond-wait"></a>cond_wait</code></em> ()</span></p></td>
398
+ <td>virtual function pointer for <a class="link" href="glib-Threads.html#g-cond-wait" title="g_cond_wait ()"><code class="function">g_cond_wait()</code></a>
399
+ </td>
400
+ </tr>
401
+ <tr>
402
+ <td><p><span class="term"><em class="structfield"><code><a name="GThreadFunctions.cond-timed-wait"></a>cond_timed_wait</code></em> ()</span></p></td>
403
+ <td>virtual function pointer for <a class="link" href="glib-Threads.html#g-cond-timed-wait" title="g_cond_timed_wait ()"><code class="function">g_cond_timed_wait()</code></a>
404
+ </td>
405
+ </tr>
406
+ <tr>
407
+ <td><p><span class="term"><em class="structfield"><code><a name="GThreadFunctions.cond-free"></a>cond_free</code></em> ()</span></p></td>
408
+ <td>virtual function pointer for <a class="link" href="glib-Threads.html#g-cond-free" title="g_cond_free ()"><code class="function">g_cond_free()</code></a>
409
+ </td>
410
+ </tr>
411
+ <tr>
412
+ <td><p><span class="term"><em class="structfield"><code><a name="GThreadFunctions.private-new"></a>private_new</code></em> ()</span></p></td>
413
+ <td>virtual function pointer for <a class="link" href="glib-Threads.html#g-private-new" title="g_private_new ()"><code class="function">g_private_new()</code></a>
414
+ </td>
415
+ </tr>
416
+ <tr>
417
+ <td><p><span class="term"><em class="structfield"><code><a name="GThreadFunctions.private-get"></a>private_get</code></em> ()</span></p></td>
418
+ <td>virtual function pointer for <a class="link" href="glib-Threads.html#g-private-get" title="g_private_get ()"><code class="function">g_private_get()</code></a>
419
+ </td>
420
+ </tr>
421
+ <tr>
422
+ <td><p><span class="term"><em class="structfield"><code><a name="GThreadFunctions.private-set"></a>private_set</code></em> ()</span></p></td>
423
+ <td>virtual function pointer for <a class="link" href="glib-Threads.html#g-private-set" title="g_private_set ()"><code class="function">g_private_set()</code></a>
424
+ </td>
425
+ </tr>
426
+ <tr>
427
+ <td><p><span class="term"><em class="structfield"><code><a name="GThreadFunctions.thread-create"></a>thread_create</code></em> ()</span></p></td>
428
+ <td>virtual function pointer for <a class="link" href="glib-Threads.html#g-thread-create" title="g_thread_create ()"><code class="function">g_thread_create()</code></a>
429
+ </td>
430
+ </tr>
431
+ <tr>
432
+ <td><p><span class="term"><em class="structfield"><code><a name="GThreadFunctions.thread-yield"></a>thread_yield</code></em> ()</span></p></td>
433
+ <td>virtual function pointer for <a class="link" href="glib-Threads.html#g-thread-yield" title="g_thread_yield ()"><code class="function">g_thread_yield()</code></a>
434
+ </td>
435
+ </tr>
436
+ <tr>
437
+ <td><p><span class="term"><em class="structfield"><code><a name="GThreadFunctions.thread-join"></a>thread_join</code></em> ()</span></p></td>
438
+ <td>virtual function pointer for <a class="link" href="glib-Threads.html#g-thread-join" title="g_thread_join ()"><code class="function">g_thread_join()</code></a>
439
+ </td>
440
+ </tr>
441
+ <tr>
442
+ <td><p><span class="term"><em class="structfield"><code><a name="GThreadFunctions.thread-exit"></a>thread_exit</code></em> ()</span></p></td>
443
+ <td>virtual function pointer for <a class="link" href="glib-Threads.html#g-thread-exit" title="g_thread_exit ()"><code class="function">g_thread_exit()</code></a>
444
+ </td>
445
+ </tr>
446
+ <tr>
447
+ <td><p><span class="term"><em class="structfield"><code><a name="GThreadFunctions.thread-set-priority"></a>thread_set_priority</code></em> ()</span></p></td>
448
+ <td>virtual function pointer for
449
+ <a class="link" href="glib-Threads.html#g-thread-set-priority" title="g_thread_set_priority ()"><code class="function">g_thread_set_priority()</code></a>
450
+ </td>
451
+ </tr>
452
+ <tr>
453
+ <td><p><span class="term"><em class="structfield"><code><a name="GThreadFunctions.thread-self"></a>thread_self</code></em> ()</span></p></td>
454
+ <td>virtual function pointer for <a class="link" href="glib-Threads.html#g-thread-self" title="g_thread_self ()"><code class="function">g_thread_self()</code></a>
455
+ </td>
456
+ </tr>
457
+ <tr>
458
+ <td><p><span class="term"><em class="structfield"><code><a name="GThreadFunctions.thread-equal"></a>thread_equal</code></em> ()</span></p></td>
459
+ <td>used internally by recursive mutex locks and by some
460
+ assertion checks
461
+ </td>
462
+ </tr>
463
+ </tbody>
464
+ </table></div>
465
+ </div>
466
+ <hr>
467
+ <div class="refsect2" title="g_thread_init ()">
468
+ <a name="g-thread-init"></a><h3>g_thread_init ()</h3>
469
+ <pre class="programlisting"><span class="returnvalue">void</span> g_thread_init (<em class="parameter"><code><a class="link" href="glib-Threads.html#GThreadFunctions" title="GThreadFunctions"><span class="type">GThreadFunctions</span></a> *vtable</code></em>);</pre>
470
+ <p>
471
+ If you use GLib from more than one thread, you must initialize the
472
+ thread system by calling <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a>. Most of the time you will
473
+ only have to call <code class="literal">g_thread_init (NULL)</code>.
474
+ </p>
475
+ <p>
476
+ </p>
477
+ <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
478
+ <h3 class="title">Note</h3>
479
+ <p>Do not call <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a> with a non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> parameter unless
480
+ you really know what you are doing.</p>
481
+ </div>
482
+ <p>
483
+ </p>
484
+ <p>
485
+ </p>
486
+ <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
487
+ <h3 class="title">Note</h3>
488
+ <p><a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a> must not be called directly or indirectly as a
489
+ callback from GLib. Also no mutexes may be currently locked while
490
+ calling <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a>.</p>
491
+ </div>
492
+ <p>
493
+ </p>
494
+ <p>
495
+ </p>
496
+ <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
497
+ <h3 class="title">Note</h3>
498
+ <p><a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a> changes the way in which <a class="link" href="glib-Timers.html#GTimer" title="GTimer"><span class="type">GTimer</span></a> measures
499
+ elapsed time. As a consequence, timers that are running while
500
+ <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a> is called may report unreliable times.</p>
501
+ </div>
502
+ <p>
503
+ </p>
504
+ <p>
505
+ Calling <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a> multiple times is allowed (since version
506
+ 2.24), but nothing happens except for the first call. If the
507
+ argument is non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> on such a call a warning will be printed, but
508
+ otherwise the argument is ignored.
509
+ </p>
510
+ <p>
511
+ If no thread system is available and <em class="parameter"><code>vtable</code></em> is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> or if not all
512
+ elements of <em class="parameter"><code>vtable</code></em> are non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, then <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a> will abort.
513
+ </p>
514
+ <p>
515
+ </p>
516
+ <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
517
+ <h3 class="title">Note</h3>
518
+ <p>To use <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a> in your program, you have to link with
519
+ the libraries that the command <span class="command"><strong>pkg-config --libs
520
+ gthread-2.0</strong></span> outputs. This is not the case for all the
521
+ other thread related functions of GLib. Those can be used without
522
+ having to link with the thread libraries.</p>
523
+ </div>
524
+ <p>
525
+ </p>
526
+ <div class="variablelist"><table border="0">
527
+ <col align="left" valign="top">
528
+ <tbody><tr>
529
+ <td><p><span class="term"><em class="parameter"><code>vtable</code></em> :</span></p></td>
530
+ <td>a function table of type <a class="link" href="glib-Threads.html#GThreadFunctions" title="GThreadFunctions"><span class="type">GThreadFunctions</span></a>, that provides
531
+ the entry points to the thread system to be used.
532
+ </td>
533
+ </tr></tbody>
534
+ </table></div>
535
+ </div>
536
+ <hr>
537
+ <div class="refsect2" title="g_thread_supported ()">
538
+ <a name="g-thread-supported"></a><h3>g_thread_supported ()</h3>
539
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_thread_supported ();</pre>
540
+ <p>
541
+ This function returns <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the thread system is initialized, and
542
+ <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> if it is not.
543
+ </p>
544
+ <p>
545
+ </p>
546
+ <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
547
+ <h3 class="title">Note</h3>
548
+ <p>This function is actually a macro. Apart from taking the
549
+ address of it you can however use it as if it was a
550
+ function.</p>
551
+ </div>
552
+ <p>
553
+ </p>
554
+ <div class="variablelist"><table border="0">
555
+ <col align="left" valign="top">
556
+ <tbody><tr>
557
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
558
+ <td>
559
+ <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a>, if the thread system is initialized.
560
+ </td>
561
+ </tr></tbody>
562
+ </table></div>
563
+ </div>
564
+ <hr>
565
+ <div class="refsect2" title="g_thread_get_initialized ()">
566
+ <a name="g-thread-get-initialized"></a><h3>g_thread_get_initialized ()</h3>
567
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_thread_get_initialized (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
568
+ <p>
569
+ Indicates if <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a> has been called.
570
+ </p>
571
+ <div class="variablelist"><table border="0">
572
+ <col align="left" valign="top">
573
+ <tbody><tr>
574
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
575
+ <td> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if threads have been initialized.
576
+
577
+ </td>
578
+ </tr></tbody>
579
+ </table></div>
580
+ <p class="since">Since 2.20</p>
581
+ </div>
582
+ <hr>
583
+ <div class="refsect2" title="GThreadFunc ()">
584
+ <a name="GThreadFunc"></a><h3>GThreadFunc ()</h3>
585
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a> (*GThreadFunc) (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
586
+ <p>
587
+ Specifies the type of the <em class="parameter"><code>func</code></em> functions passed to
588
+ <a class="link" href="glib-Threads.html#g-thread-create" title="g_thread_create ()"><code class="function">g_thread_create()</code></a> or <a class="link" href="glib-Threads.html#g-thread-create-full" title="g_thread_create_full ()"><code class="function">g_thread_create_full()</code></a>.
589
+ </p>
590
+ <div class="variablelist"><table border="0">
591
+ <col align="left" valign="top">
592
+ <tbody>
593
+ <tr>
594
+ <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
595
+ <td>data passed to the thread.
596
+ </td>
597
+ </tr>
598
+ <tr>
599
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
600
+ <td>the return value of the thread, which will be returned by
601
+ <a class="link" href="glib-Threads.html#g-thread-join" title="g_thread_join ()"><code class="function">g_thread_join()</code></a>.
602
+ </td>
603
+ </tr>
604
+ </tbody>
605
+ </table></div>
606
+ </div>
607
+ <hr>
608
+ <div class="refsect2" title="enum GThreadPriority">
609
+ <a name="GThreadPriority"></a><h3>enum GThreadPriority</h3>
610
+ <pre class="programlisting">typedef enum
611
+ {
612
+ G_THREAD_PRIORITY_LOW,
613
+ G_THREAD_PRIORITY_NORMAL,
614
+ G_THREAD_PRIORITY_HIGH,
615
+ G_THREAD_PRIORITY_URGENT
616
+ } GThreadPriority;
617
+ </pre>
618
+ <p>
619
+ Specifies the priority of a thread.
620
+ </p>
621
+ <p>
622
+ </p>
623
+ <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
624
+ <h3 class="title">Note</h3>
625
+ <p>It is not guaranteed that threads with different priorities
626
+ really behave accordingly. On some systems (e.g. Linux) there are no
627
+ thread priorities. On other systems (e.g. Solaris) there doesn't
628
+ seem to be different scheduling for different priorities. All in all
629
+ try to avoid being dependent on priorities.</p>
630
+ </div>
631
+ <p>
632
+ </p>
633
+ <div class="variablelist"><table border="0">
634
+ <col align="left" valign="top">
635
+ <tbody>
636
+ <tr>
637
+ <td><p><a name="G-THREAD-PRIORITY-LOW:CAPS"></a><span class="term"><code class="literal">G_THREAD_PRIORITY_LOW</code></span></p></td>
638
+ <td>a priority lower than normal
639
+ </td>
640
+ </tr>
641
+ <tr>
642
+ <td><p><a name="G-THREAD-PRIORITY-NORMAL:CAPS"></a><span class="term"><code class="literal">G_THREAD_PRIORITY_NORMAL</code></span></p></td>
643
+ <td>the default priority
644
+ </td>
645
+ </tr>
646
+ <tr>
647
+ <td><p><a name="G-THREAD-PRIORITY-HIGH:CAPS"></a><span class="term"><code class="literal">G_THREAD_PRIORITY_HIGH</code></span></p></td>
648
+ <td>a priority higher than normal
649
+ </td>
650
+ </tr>
651
+ <tr>
652
+ <td><p><a name="G-THREAD-PRIORITY-URGENT:CAPS"></a><span class="term"><code class="literal">G_THREAD_PRIORITY_URGENT</code></span></p></td>
653
+ <td>the highest priority
654
+ </td>
655
+ </tr>
656
+ </tbody>
657
+ </table></div>
658
+ </div>
659
+ <hr>
660
+ <div class="refsect2" title="GThread">
661
+ <a name="GThread"></a><h3>GThread</h3>
662
+ <pre class="programlisting">typedef struct {
663
+ } GThread;
664
+ </pre>
665
+ <p>
666
+ The <a class="link" href="glib-Threads.html#GThread" title="GThread"><span class="type">GThread</span></a> struct represents a running thread. It has three public
667
+ read-only members, but the underlying struct is bigger, so you must
668
+ not copy this struct.
669
+ </p>
670
+ <p>
671
+ </p>
672
+ <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
673
+ <h3 class="title">Note</h3>
674
+ <p>Resources for a joinable thread are not fully released
675
+ until <a class="link" href="glib-Threads.html#g-thread-join" title="g_thread_join ()"><code class="function">g_thread_join()</code></a> is called for that thread.</p>
676
+ </div>
677
+ <p>
678
+ </p>
679
+ </div>
680
+ <hr>
681
+ <div class="refsect2" title="g_thread_create ()">
682
+ <a name="g-thread-create"></a><h3>g_thread_create ()</h3>
683
+ <pre class="programlisting"><a class="link" href="glib-Threads.html#GThread" title="GThread"><span class="returnvalue">GThread</span></a> * g_thread_create (<em class="parameter"><code><a class="link" href="glib-Threads.html#GThreadFunc" title="GThreadFunc ()"><span class="type">GThreadFunc</span></a> func</code></em>,
684
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> data</code></em>,
685
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="type">gboolean</span></a> joinable</code></em>,
686
+ <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);</pre>
687
+ <p>
688
+ This function creates a new thread with the default priority.
689
+ </p>
690
+ <p>
691
+ If <em class="parameter"><code>joinable</code></em> is <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a>, you can wait for this threads termination
692
+ calling <a class="link" href="glib-Threads.html#g-thread-join" title="g_thread_join ()"><code class="function">g_thread_join()</code></a>. Otherwise the thread will just disappear
693
+ when it terminates.
694
+ </p>
695
+ <p>
696
+ The new thread executes the function <em class="parameter"><code>func</code></em> with the argument <em class="parameter"><code>data</code></em>.
697
+ If the thread was created successfully, it is returned.
698
+ </p>
699
+ <p>
700
+ <em class="parameter"><code>error</code></em> can be <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> to ignore errors, or non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> to report errors.
701
+ The error is set, if and only if the function returns <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
702
+ </p>
703
+ <div class="variablelist"><table border="0">
704
+ <col align="left" valign="top">
705
+ <tbody>
706
+ <tr>
707
+ <td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
708
+ <td>a function to execute in the new thread.
709
+ </td>
710
+ </tr>
711
+ <tr>
712
+ <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
713
+ <td>an argument to supply to the new thread.
714
+ </td>
715
+ </tr>
716
+ <tr>
717
+ <td><p><span class="term"><em class="parameter"><code>joinable</code></em> :</span></p></td>
718
+ <td>should this thread be joinable?
719
+ </td>
720
+ </tr>
721
+ <tr>
722
+ <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
723
+ <td>return location for error.
724
+ </td>
725
+ </tr>
726
+ <tr>
727
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
728
+ <td>the new <a class="link" href="glib-Threads.html#GThread" title="GThread"><span class="type">GThread</span></a> on success.
729
+ </td>
730
+ </tr>
731
+ </tbody>
732
+ </table></div>
733
+ </div>
734
+ <hr>
735
+ <div class="refsect2" title="g_thread_create_full ()">
736
+ <a name="g-thread-create-full"></a><h3>g_thread_create_full ()</h3>
737
+ <pre class="programlisting"><a class="link" href="glib-Threads.html#GThread" title="GThread"><span class="returnvalue">GThread</span></a>* g_thread_create_full (<em class="parameter"><code><a class="link" href="glib-Threads.html#GThreadFunc" title="GThreadFunc ()"><span class="type">GThreadFunc</span></a> func</code></em>,
738
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> data</code></em>,
739
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gulong" title="gulong"><span class="type">gulong</span></a> stack_size</code></em>,
740
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="type">gboolean</span></a> joinable</code></em>,
741
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="type">gboolean</span></a> bound</code></em>,
742
+ <em class="parameter"><code><a class="link" href="glib-Threads.html#GThreadPriority" title="enum GThreadPriority"><span class="type">GThreadPriority</span></a> priority</code></em>,
743
+ <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);</pre>
744
+ <p>
745
+ This function creates a new thread with the priority <em class="parameter"><code>priority</code></em>. If
746
+ the underlying thread implementation supports it, the thread gets a
747
+ stack size of <em class="parameter"><code>stack_size</code></em> or the default value for the current
748
+ platform, if <em class="parameter"><code>stack_size</code></em> is 0.
749
+ </p>
750
+ <p>
751
+ If <em class="parameter"><code>joinable</code></em> is <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a>, you can wait for this threads termination
752
+ calling <a class="link" href="glib-Threads.html#g-thread-join" title="g_thread_join ()"><code class="function">g_thread_join()</code></a>. Otherwise the thread will just disappear
753
+ when it terminates. If <em class="parameter"><code>bound</code></em> is <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a>, this thread will be
754
+ scheduled in the system scope, otherwise the implementation is free
755
+ to do scheduling in the process scope. The first variant is more
756
+ expensive resource-wise, but generally faster. On some systems (e.g.
757
+ Linux) all threads are bound.
758
+ </p>
759
+ <p>
760
+ The new thread executes the function <em class="parameter"><code>func</code></em> with the argument <em class="parameter"><code>data</code></em>.
761
+ If the thread was created successfully, it is returned.
762
+ </p>
763
+ <p>
764
+ <em class="parameter"><code>error</code></em> can be <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> to ignore errors, or non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> to report errors.
765
+ The error is set, if and only if the function returns <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
766
+ </p>
767
+ <p>
768
+ </p>
769
+ <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
770
+ <h3 class="title">Note</h3>
771
+ <p>It is not guaranteed that threads with different priorities
772
+ really behave accordingly. On some systems (e.g. Linux) there are no
773
+ thread priorities. On other systems (e.g. Solaris) there doesn't
774
+ seem to be different scheduling for different priorities. All in all
775
+ try to avoid being dependent on priorities. Use
776
+ <a class="link" href="glib-Threads.html#G-THREAD-PRIORITY-NORMAL:CAPS"><code class="literal">G_THREAD_PRIORITY_NORMAL</code></a> here as a default.</p>
777
+ </div>
778
+ <p>
779
+ </p>
780
+ <p>
781
+ </p>
782
+ <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
783
+ <h3 class="title">Note</h3>
784
+ <p>Only use <a class="link" href="glib-Threads.html#g-thread-create-full" title="g_thread_create_full ()"><code class="function">g_thread_create_full()</code></a> if you really can't use
785
+ <a class="link" href="glib-Threads.html#g-thread-create" title="g_thread_create ()"><code class="function">g_thread_create()</code></a> instead. <a class="link" href="glib-Threads.html#g-thread-create" title="g_thread_create ()"><code class="function">g_thread_create()</code></a> does not take
786
+ <em class="parameter"><code>stack_size</code></em>, <em class="parameter"><code>bound</code></em>, and <em class="parameter"><code>priority</code></em> as arguments, as they should only
787
+ be used in cases in which it is unavoidable.</p>
788
+ </div>
789
+ <p>
790
+ </p>
791
+ <div class="variablelist"><table border="0">
792
+ <col align="left" valign="top">
793
+ <tbody>
794
+ <tr>
795
+ <td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
796
+ <td>a function to execute in the new thread.
797
+ </td>
798
+ </tr>
799
+ <tr>
800
+ <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
801
+ <td>an argument to supply to the new thread.
802
+ </td>
803
+ </tr>
804
+ <tr>
805
+ <td><p><span class="term"><em class="parameter"><code>stack_size</code></em> :</span></p></td>
806
+ <td>a stack size for the new thread.
807
+ </td>
808
+ </tr>
809
+ <tr>
810
+ <td><p><span class="term"><em class="parameter"><code>joinable</code></em> :</span></p></td>
811
+ <td>should this thread be joinable?
812
+ </td>
813
+ </tr>
814
+ <tr>
815
+ <td><p><span class="term"><em class="parameter"><code>bound</code></em> :</span></p></td>
816
+ <td>should this thread be bound to a system thread?
817
+ </td>
818
+ </tr>
819
+ <tr>
820
+ <td><p><span class="term"><em class="parameter"><code>priority</code></em> :</span></p></td>
821
+ <td>a priority for the thread.
822
+ </td>
823
+ </tr>
824
+ <tr>
825
+ <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
826
+ <td>return location for error.
827
+ </td>
828
+ </tr>
829
+ <tr>
830
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
831
+ <td>the new <a class="link" href="glib-Threads.html#GThread" title="GThread"><span class="type">GThread</span></a> on success.
832
+ </td>
833
+ </tr>
834
+ </tbody>
835
+ </table></div>
836
+ </div>
837
+ <hr>
838
+ <div class="refsect2" title="g_thread_self ()">
839
+ <a name="g-thread-self"></a><h3>g_thread_self ()</h3>
840
+ <pre class="programlisting"><a class="link" href="glib-Threads.html#GThread" title="GThread"><span class="returnvalue">GThread</span></a>* g_thread_self (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
841
+ <p>
842
+ This functions returns the <a class="link" href="glib-Threads.html#GThread" title="GThread"><span class="type">GThread</span></a> corresponding to the calling
843
+ thread.
844
+ </p>
845
+ <div class="variablelist"><table border="0">
846
+ <col align="left" valign="top">
847
+ <tbody><tr>
848
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
849
+ <td>the current thread.
850
+ </td>
851
+ </tr></tbody>
852
+ </table></div>
853
+ </div>
854
+ <hr>
855
+ <div class="refsect2" title="g_thread_join ()">
856
+ <a name="g-thread-join"></a><h3>g_thread_join ()</h3>
857
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a> g_thread_join (<em class="parameter"><code><a class="link" href="glib-Threads.html#GThread" title="GThread"><span class="type">GThread</span></a> *thread</code></em>);</pre>
858
+ <p>
859
+ Waits until <em class="parameter"><code>thread</code></em> finishes, i.e. the function <em class="parameter"><code>func</code></em>, as given to
860
+ <a class="link" href="glib-Threads.html#g-thread-create" title="g_thread_create ()"><code class="function">g_thread_create()</code></a>, returns or <a class="link" href="glib-Threads.html#g-thread-exit" title="g_thread_exit ()"><code class="function">g_thread_exit()</code></a> is called by <em class="parameter"><code>thread</code></em>.
861
+ All resources of <em class="parameter"><code>thread</code></em> including the <a class="link" href="glib-Threads.html#GThread" title="GThread"><span class="type">GThread</span></a> struct are released.
862
+ <em class="parameter"><code>thread</code></em> must have been created with <em class="parameter"><code>joinable</code></em>=<a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> in
863
+ <a class="link" href="glib-Threads.html#g-thread-create" title="g_thread_create ()"><code class="function">g_thread_create()</code></a>. The value returned by <em class="parameter"><code>func</code></em> or given to
864
+ <a class="link" href="glib-Threads.html#g-thread-exit" title="g_thread_exit ()"><code class="function">g_thread_exit()</code></a> by <em class="parameter"><code>thread</code></em> is returned by this function.
865
+ </p>
866
+ <div class="variablelist"><table border="0">
867
+ <col align="left" valign="top">
868
+ <tbody>
869
+ <tr>
870
+ <td><p><span class="term"><em class="parameter"><code>thread</code></em> :</span></p></td>
871
+ <td>a <a class="link" href="glib-Threads.html#GThread" title="GThread"><span class="type">GThread</span></a> to be waited for.
872
+ </td>
873
+ </tr>
874
+ <tr>
875
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
876
+ <td>the return value of the thread.
877
+ </td>
878
+ </tr>
879
+ </tbody>
880
+ </table></div>
881
+ </div>
882
+ <hr>
883
+ <div class="refsect2" title="g_thread_set_priority ()">
884
+ <a name="g-thread-set-priority"></a><h3>g_thread_set_priority ()</h3>
885
+ <pre class="programlisting"><span class="returnvalue">void</span> g_thread_set_priority (<em class="parameter"><code><a class="link" href="glib-Threads.html#GThread" title="GThread"><span class="type">GThread</span></a> *thread</code></em>,
886
+ <em class="parameter"><code><a class="link" href="glib-Threads.html#GThreadPriority" title="enum GThreadPriority"><span class="type">GThreadPriority</span></a> priority</code></em>);</pre>
887
+ <p>
888
+ Changes the priority of <em class="parameter"><code>thread</code></em> to <em class="parameter"><code>priority</code></em>.
889
+ </p>
890
+ <p>
891
+ </p>
892
+ <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
893
+ <h3 class="title">Note</h3>
894
+ <p>It is not guaranteed that threads with different
895
+ priorities really behave accordingly. On some systems (e.g. Linux)
896
+ there are no thread priorities. On other systems (e.g. Solaris) there
897
+ doesn't seem to be different scheduling for different priorities. All
898
+ in all try to avoid being dependent on priorities.</p>
899
+ </div>
900
+ <p>
901
+ </p>
902
+ <div class="variablelist"><table border="0">
903
+ <col align="left" valign="top">
904
+ <tbody>
905
+ <tr>
906
+ <td><p><span class="term"><em class="parameter"><code>thread</code></em> :</span></p></td>
907
+ <td>a <a class="link" href="glib-Threads.html#GThread" title="GThread"><span class="type">GThread</span></a>.
908
+ </td>
909
+ </tr>
910
+ <tr>
911
+ <td><p><span class="term"><em class="parameter"><code>priority</code></em> :</span></p></td>
912
+ <td>a new priority for <em class="parameter"><code>thread</code></em>.
913
+ </td>
914
+ </tr>
915
+ </tbody>
916
+ </table></div>
917
+ </div>
918
+ <hr>
919
+ <div class="refsect2" title="g_thread_yield ()">
920
+ <a name="g-thread-yield"></a><h3>g_thread_yield ()</h3>
921
+ <pre class="programlisting"><span class="returnvalue">void</span> g_thread_yield ();</pre>
922
+ <p>
923
+ Gives way to other threads waiting to be scheduled.
924
+ </p>
925
+ <p>
926
+ This function is often used as a method to make busy wait less evil.
927
+ But in most cases you will encounter, there are better methods to do
928
+ that. So in general you shouldn't use this function.
929
+ </p>
930
+ </div>
931
+ <hr>
932
+ <div class="refsect2" title="g_thread_exit ()">
933
+ <a name="g-thread-exit"></a><h3>g_thread_exit ()</h3>
934
+ <pre class="programlisting"><span class="returnvalue">void</span> g_thread_exit (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> retval</code></em>);</pre>
935
+ <p>
936
+ Exits the current thread. If another thread is waiting for that
937
+ thread using <a class="link" href="glib-Threads.html#g-thread-join" title="g_thread_join ()"><code class="function">g_thread_join()</code></a> and the current thread is joinable, the
938
+ waiting thread will be woken up and get <em class="parameter"><code>retval</code></em> as the return value
939
+ of <a class="link" href="glib-Threads.html#g-thread-join" title="g_thread_join ()"><code class="function">g_thread_join()</code></a>. If the current thread is not joinable, <em class="parameter"><code>retval</code></em>
940
+ is ignored. Calling
941
+ </p>
942
+ <p>
943
+ </p>
944
+ <div class="informalexample">
945
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
946
+ <tbody>
947
+ <tr>
948
+ <td class="listing_lines" align="right"><pre>1</pre></td>
949
+ <td class="listing_code"><pre class="programlisting"><span class="function"><a href="glib-Threads.html#g-thread-exit">g_thread_exit</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">retval</span><span class="symbol">);</span></pre></td>
950
+ </tr>
951
+ </tbody>
952
+ </table>
953
+ </div>
954
+
955
+ <p>
956
+ </p>
957
+ <p>
958
+ is equivalent to returning <em class="parameter"><code>retval</code></em> from the function <em class="parameter"><code>func</code></em>, as given
959
+ to <a class="link" href="glib-Threads.html#g-thread-create" title="g_thread_create ()"><code class="function">g_thread_create()</code></a>.
960
+ </p>
961
+ <p>
962
+ </p>
963
+ <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
964
+ <h3 class="title">Note</h3>
965
+ <p>Never call <a class="link" href="glib-Threads.html#g-thread-exit" title="g_thread_exit ()"><code class="function">g_thread_exit()</code></a> from within a thread of a
966
+ <a class="link" href="glib-Thread-Pools.html#GThreadPool" title="GThreadPool"><span class="type">GThreadPool</span></a>, as that will mess up the bookkeeping and lead to funny
967
+ and unwanted results.</p>
968
+ </div>
969
+ <p>
970
+ </p>
971
+ <div class="variablelist"><table border="0">
972
+ <col align="left" valign="top">
973
+ <tbody><tr>
974
+ <td><p><span class="term"><em class="parameter"><code>retval</code></em> :</span></p></td>
975
+ <td>the return value of this thread.
976
+ </td>
977
+ </tr></tbody>
978
+ </table></div>
979
+ </div>
980
+ <hr>
981
+ <div class="refsect2" title="g_thread_foreach ()">
982
+ <a name="g-thread-foreach"></a><h3>g_thread_foreach ()</h3>
983
+ <pre class="programlisting"><span class="returnvalue">void</span> g_thread_foreach (<em class="parameter"><code><a class="link" href="glib-Doubly-Linked-Lists.html#GFunc" title="GFunc ()"><span class="type">GFunc</span></a> thread_func</code></em>,
984
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
985
+ <p>
986
+ Call <em class="parameter"><code>thread_func</code></em> on all existing <a class="link" href="glib-Threads.html#GThread" title="GThread"><span class="type">GThread</span></a> structures. Note that
987
+ threads may decide to exit while <em class="parameter"><code>thread_func</code></em> is running, so
988
+ without intimate knowledge about the lifetime of foreign threads,
989
+ <em class="parameter"><code>thread_func</code></em> shouldn't access the GThread* pointer passed in as
990
+ first argument. However, <em class="parameter"><code>thread_func</code></em> will not be called for threads
991
+ which are known to have exited already.
992
+ </p>
993
+ <p>
994
+ Due to thread lifetime checks, this function has an execution complexity
995
+ which is quadratic in the number of existing threads.
996
+ </p>
997
+ <div class="variablelist"><table border="0">
998
+ <col align="left" valign="top">
999
+ <tbody>
1000
+ <tr>
1001
+ <td><p><span class="term"><em class="parameter"><code>thread_func</code></em> :</span></p></td>
1002
+ <td>function to call for all GThread structures
1003
+ </td>
1004
+ </tr>
1005
+ <tr>
1006
+ <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1007
+ <td>second argument to <em class="parameter"><code>thread_func</code></em>
1008
+ </td>
1009
+ </tr>
1010
+ </tbody>
1011
+ </table></div>
1012
+ <p class="since">Since 2.10</p>
1013
+ </div>
1014
+ <hr>
1015
+ <div class="refsect2" title="GMutex">
1016
+ <a name="GMutex"></a><h3>GMutex</h3>
1017
+ <pre class="programlisting">typedef struct _GMutex GMutex;</pre>
1018
+ <p>
1019
+ The <a class="link" href="glib-Threads.html#GMutex" title="GMutex"><span class="type">GMutex</span></a> struct is an opaque data structure to represent a mutex
1020
+ (mutual exclusion). It can be used to protect data against shared
1021
+ access. Take for example the following function:
1022
+ </p>
1023
+ <p>
1024
+ </p>
1025
+ <div class="example">
1026
+ <a name="id605647"></a><p class="title"><b>Example 2. A function which will not work in a threaded environment</b></p>
1027
+ <div class="example-contents">
1028
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
1029
+ <tbody>
1030
+ <tr>
1031
+ <td class="listing_lines" align="right"><pre>1
1032
+ 2
1033
+ 3
1034
+ 4
1035
+ 5
1036
+ 6
1037
+ 7
1038
+ 8
1039
+ 9
1040
+ 10
1041
+ 11
1042
+ 12</pre></td>
1043
+ <td class="listing_code"><pre class="programlisting"><span class="type">int</span>
1044
+ <span class="function">give_me_next_number</span><span class="normal"> </span><span class="symbol">(</span><span class="type">void</span><span class="symbol">)</span>
1045
+ <span class="cbracket">{</span>
1046
+ <span class="normal"> </span><span class="keyword">static</span><span class="normal"> </span><span class="type">int</span><span class="normal"> current_number </span><span class="symbol">=</span><span class="normal"> </span><span class="number">0</span><span class="symbol">;</span>
1047
+
1048
+ <span class="normal"> </span><span class="comment">/* now do a very complicated calculation to calculate the new</span>
1049
+ <span class="comment"> * number, this might for example be a random number generator</span>
1050
+ <span class="comment"> */</span>
1051
+ <span class="normal"> current_number </span><span class="symbol">=</span><span class="normal"> </span><span class="function">calc_next_number</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">current_number</span><span class="symbol">);</span>
1052
+
1053
+ <span class="normal"> </span><span class="keyword">return</span><span class="normal"> current_number</span><span class="symbol">;</span>
1054
+ <span class="cbracket">}</span></pre></td>
1055
+ </tr>
1056
+ </tbody>
1057
+ </table>
1058
+ </div>
1059
+
1060
+ </div>
1061
+ <p><br class="example-break">
1062
+ </p>
1063
+ <p>
1064
+ It is easy to see that this won't work in a multi-threaded
1065
+ application. There current_number must be protected against shared
1066
+ access. A first naive implementation would be:
1067
+ </p>
1068
+ <p>
1069
+ </p>
1070
+ <div class="example">
1071
+ <a name="id605678"></a><p class="title"><b>Example 3. The wrong way to write a thread-safe function</b></p>
1072
+ <div class="example-contents">
1073
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
1074
+ <tbody>
1075
+ <tr>
1076
+ <td class="listing_lines" align="right"><pre>1
1077
+ 2
1078
+ 3
1079
+ 4
1080
+ 5
1081
+ 6
1082
+ 7
1083
+ 8
1084
+ 9
1085
+ 10
1086
+ 11
1087
+ 12
1088
+ 13
1089
+ 14
1090
+ 15</pre></td>
1091
+ <td class="listing_code"><pre class="programlisting"><span class="type">int</span>
1092
+ <span class="function">give_me_next_number</span><span class="normal"> </span><span class="symbol">(</span><span class="type">void</span><span class="symbol">)</span>
1093
+ <span class="cbracket">{</span>
1094
+ <span class="normal"> </span><span class="keyword">static</span><span class="normal"> </span><span class="type">int</span><span class="normal"> current_number </span><span class="symbol">=</span><span class="normal"> </span><span class="number">0</span><span class="symbol">;</span>
1095
+ <span class="normal"> </span><span class="type">int</span><span class="normal"> ret_val</span><span class="symbol">;</span>
1096
+ <span class="normal"> </span><span class="keyword">static</span><span class="normal"> <a href="glib-Threads.html#GMutex">GMutex</a> </span><span class="symbol">*</span><span class="normal"> mutex </span><span class="symbol">=</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
1097
+
1098
+ <span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(!</span><span class="normal">mutex</span><span class="symbol">)</span><span class="normal"> mutex </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-Threads.html#g-mutex-new">g_mutex_new</a></span><span class="normal"> </span><span class="symbol">();</span>
1099
+
1100
+ <span class="normal"> </span><span class="function"><a href="glib-Threads.html#g-mutex-lock">g_mutex_lock</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">mutex</span><span class="symbol">);</span>
1101
+ <span class="normal"> ret_val </span><span class="symbol">=</span><span class="normal"> current_number </span><span class="symbol">=</span><span class="normal"> </span><span class="function">calc_next_number</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">current_number</span><span class="symbol">);</span>
1102
+ <span class="normal"> </span><span class="function"><a href="glib-Threads.html#g-mutex-unlock">g_mutex_unlock</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">mutex</span><span class="symbol">);</span>
1103
+
1104
+ <span class="normal"> </span><span class="keyword">return</span><span class="normal"> ret_val</span><span class="symbol">;</span>
1105
+ <span class="cbracket">}</span></pre></td>
1106
+ </tr>
1107
+ </tbody>
1108
+ </table>
1109
+ </div>
1110
+
1111
+ </div>
1112
+ <p><br class="example-break">
1113
+ </p>
1114
+ <p>
1115
+ This looks like it would work, but there is a race condition while
1116
+ constructing the mutex and this code cannot work reliable. Please do
1117
+ not use such constructs in your own programs! One working solution
1118
+ is:
1119
+ </p>
1120
+ <p>
1121
+ </p>
1122
+ <div class="example">
1123
+ <a name="id605707"></a><p class="title"><b>Example 4. A correct thread-safe function</b></p>
1124
+ <div class="example-contents">
1125
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
1126
+ <tbody>
1127
+ <tr>
1128
+ <td class="listing_lines" align="right"><pre>1
1129
+ 2
1130
+ 3
1131
+ 4
1132
+ 5
1133
+ 6
1134
+ 7
1135
+ 8
1136
+ 9
1137
+ 10
1138
+ 11
1139
+ 12
1140
+ 13
1141
+ 14
1142
+ 15
1143
+ 16
1144
+ 17
1145
+ 18
1146
+ 19
1147
+ 20
1148
+ 21
1149
+ 22
1150
+ 23
1151
+ 24
1152
+ 25
1153
+ 26</pre></td>
1154
+ <td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> </span><span class="usertype">GMutex</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">give_me_next_number_mutex </span><span class="symbol">=</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
1155
+
1156
+ <span class="comment">/* this function must be called before any call to</span>
1157
+ <span class="comment"> * give_me_next_number()</span>
1158
+ <span class="comment"> *</span>
1159
+ <span class="comment"> * it must be called exactly once.</span>
1160
+ <span class="comment"> */</span>
1161
+ <span class="type">void</span>
1162
+ <span class="function">init_give_me_next_number</span><span class="normal"> </span><span class="symbol">(</span><span class="type">void</span><span class="symbol">)</span>
1163
+ <span class="cbracket">{</span>
1164
+ <span class="normal"> </span><span class="function"><a href="glib-Testing.html#g-assert">g_assert</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">give_me_next_number_mutex </span><span class="symbol">==</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
1165
+ <span class="normal"> give_me_next_number_mutex </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-Threads.html#g-mutex-new">g_mutex_new</a></span><span class="normal"> </span><span class="symbol">();</span>
1166
+ <span class="cbracket">}</span>
1167
+
1168
+ <span class="type">int</span>
1169
+ <span class="function">give_me_next_number</span><span class="normal"> </span><span class="symbol">(</span><span class="type">void</span><span class="symbol">)</span>
1170
+ <span class="cbracket">{</span>
1171
+ <span class="normal"> </span><span class="keyword">static</span><span class="normal"> </span><span class="type">int</span><span class="normal"> current_number </span><span class="symbol">=</span><span class="normal"> </span><span class="number">0</span><span class="symbol">;</span>
1172
+ <span class="normal"> </span><span class="type">int</span><span class="normal"> ret_val</span><span class="symbol">;</span>
1173
+
1174
+ <span class="normal"> </span><span class="function"><a href="glib-Threads.html#g-mutex-lock">g_mutex_lock</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">give_me_next_number_mutex</span><span class="symbol">);</span>
1175
+ <span class="normal"> ret_val </span><span class="symbol">=</span><span class="normal"> current_number </span><span class="symbol">=</span><span class="normal"> </span><span class="function">calc_next_number</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">current_number</span><span class="symbol">);</span>
1176
+ <span class="normal"> </span><span class="function"><a href="glib-Threads.html#g-mutex-unlock">g_mutex_unlock</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">give_me_next_number_mutex</span><span class="symbol">);</span>
1177
+
1178
+ <span class="normal"> </span><span class="keyword">return</span><span class="normal"> ret_val</span><span class="symbol">;</span>
1179
+ <span class="cbracket">}</span></pre></td>
1180
+ </tr>
1181
+ </tbody>
1182
+ </table>
1183
+ </div>
1184
+
1185
+ </div>
1186
+ <p><br class="example-break">
1187
+ </p>
1188
+ <p>
1189
+ <a class="link" href="glib-Threads.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a> provides a simpler and safer way of doing this.
1190
+ </p>
1191
+ <p>
1192
+ If you want to use a mutex, and your code should also work without
1193
+ calling <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a> first, then you can not use a <a class="link" href="glib-Threads.html#GMutex" title="GMutex"><span class="type">GMutex</span></a>, as
1194
+ <a class="link" href="glib-Threads.html#g-mutex-new" title="g_mutex_new ()"><code class="function">g_mutex_new()</code></a> requires that the thread system be initialized. Use a
1195
+ <a class="link" href="glib-Threads.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a> instead.
1196
+ </p>
1197
+ <p>
1198
+ A <a class="link" href="glib-Threads.html#GMutex" title="GMutex"><span class="type">GMutex</span></a> should only be accessed via the following functions.
1199
+ </p>
1200
+ <p>
1201
+ </p>
1202
+ <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
1203
+ <h3 class="title">Note</h3>
1204
+ <p>All of the <code class="function">g_mutex_*</code> functions are
1205
+ actually macros. Apart from taking their addresses, you can however
1206
+ use them as if they were functions.</p>
1207
+ </div>
1208
+ <p>
1209
+ </p>
1210
+ </div>
1211
+ <hr>
1212
+ <div class="refsect2" title="g_mutex_new ()">
1213
+ <a name="g-mutex-new"></a><h3>g_mutex_new ()</h3>
1214
+ <pre class="programlisting"><a class="link" href="glib-Threads.html#GMutex" title="GMutex"><span class="returnvalue">GMutex</span></a> * g_mutex_new ();</pre>
1215
+ <p>
1216
+ Creates a new <a class="link" href="glib-Threads.html#GMutex" title="GMutex"><span class="type">GMutex</span></a>.
1217
+ </p>
1218
+ <p>
1219
+ </p>
1220
+ <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
1221
+ <h3 class="title">Note</h3>
1222
+ <p>This function will abort if <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a> has not been
1223
+ called yet.</p>
1224
+ </div>
1225
+ <p>
1226
+ </p>
1227
+ <div class="variablelist"><table border="0">
1228
+ <col align="left" valign="top">
1229
+ <tbody><tr>
1230
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1231
+ <td>a new <a class="link" href="glib-Threads.html#GMutex" title="GMutex"><span class="type">GMutex</span></a>.
1232
+ </td>
1233
+ </tr></tbody>
1234
+ </table></div>
1235
+ </div>
1236
+ <hr>
1237
+ <div class="refsect2" title="g_mutex_lock ()">
1238
+ <a name="g-mutex-lock"></a><h3>g_mutex_lock ()</h3>
1239
+ <pre class="programlisting"><span class="returnvalue">void</span> g_mutex_lock (<em class="parameter"><code><a class="link" href="glib-Threads.html#GMutex" title="GMutex"><span class="type">GMutex</span></a> *mutex</code></em>);</pre>
1240
+ <p>
1241
+ Locks <em class="parameter"><code>mutex</code></em>. If <em class="parameter"><code>mutex</code></em> is already locked by another thread, the
1242
+ current thread will block until <em class="parameter"><code>mutex</code></em> is unlocked by the other
1243
+ thread.
1244
+ </p>
1245
+ <p>
1246
+ This function can be used even if <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a> has not yet been
1247
+ called, and, in that case, will do nothing.
1248
+ </p>
1249
+ <p>
1250
+ </p>
1251
+ <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
1252
+ <h3 class="title">Note</h3>
1253
+ <p><a class="link" href="glib-Threads.html#GMutex" title="GMutex"><span class="type">GMutex</span></a> is neither guaranteed to be recursive nor to be
1254
+ non-recursive, i.e. a thread could deadlock while calling
1255
+ <a class="link" href="glib-Threads.html#g-mutex-lock" title="g_mutex_lock ()"><code class="function">g_mutex_lock()</code></a>, if it already has locked <em class="parameter"><code>mutex</code></em>. Use
1256
+ <a class="link" href="glib-Threads.html#GStaticRecMutex" title="GStaticRecMutex"><span class="type">GStaticRecMutex</span></a>, if you need recursive mutexes.</p>
1257
+ </div>
1258
+ <p>
1259
+ </p>
1260
+ <div class="variablelist"><table border="0">
1261
+ <col align="left" valign="top">
1262
+ <tbody><tr>
1263
+ <td><p><span class="term"><em class="parameter"><code>mutex</code></em> :</span></p></td>
1264
+ <td>a <a class="link" href="glib-Threads.html#GMutex" title="GMutex"><span class="type">GMutex</span></a>.
1265
+ </td>
1266
+ </tr></tbody>
1267
+ </table></div>
1268
+ </div>
1269
+ <hr>
1270
+ <div class="refsect2" title="g_mutex_trylock ()">
1271
+ <a name="g-mutex-trylock"></a><h3>g_mutex_trylock ()</h3>
1272
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_mutex_trylock (<em class="parameter"><code><a class="link" href="glib-Threads.html#GMutex" title="GMutex"><span class="type">GMutex</span></a> *mutex</code></em>);</pre>
1273
+ <p>
1274
+ Tries to lock <em class="parameter"><code>mutex</code></em>. If <em class="parameter"><code>mutex</code></em> is already locked by another thread,
1275
+ it immediately returns <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a>. Otherwise it locks <em class="parameter"><code>mutex</code></em> and returns
1276
+ <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a>.
1277
+ </p>
1278
+ <p>
1279
+ This function can be used even if <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a> has not yet been
1280
+ called, and, in that case, will immediately return <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a>.
1281
+ </p>
1282
+ <p>
1283
+ </p>
1284
+ <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
1285
+ <h3 class="title">Note</h3>
1286
+ <p><a class="link" href="glib-Threads.html#GMutex" title="GMutex"><span class="type">GMutex</span></a> is neither guaranteed to be recursive nor to be
1287
+ non-recursive, i.e. the return value of <a class="link" href="glib-Threads.html#g-mutex-trylock" title="g_mutex_trylock ()"><code class="function">g_mutex_trylock()</code></a> could be
1288
+ both <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> or <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a>, if the current thread already has locked
1289
+ <em class="parameter"><code>mutex</code></em>. Use <a class="link" href="glib-Threads.html#GStaticRecMutex" title="GStaticRecMutex"><span class="type">GStaticRecMutex</span></a>, if you need recursive
1290
+ mutexes.</p>
1291
+ </div>
1292
+ <p>
1293
+ </p>
1294
+ <div class="variablelist"><table border="0">
1295
+ <col align="left" valign="top">
1296
+ <tbody>
1297
+ <tr>
1298
+ <td><p><span class="term"><em class="parameter"><code>mutex</code></em> :</span></p></td>
1299
+ <td>a <a class="link" href="glib-Threads.html#GMutex" title="GMutex"><span class="type">GMutex</span></a>.
1300
+ </td>
1301
+ </tr>
1302
+ <tr>
1303
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1304
+ <td>
1305
+ <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a>, if <em class="parameter"><code>mutex</code></em> could be locked.
1306
+ </td>
1307
+ </tr>
1308
+ </tbody>
1309
+ </table></div>
1310
+ </div>
1311
+ <hr>
1312
+ <div class="refsect2" title="g_mutex_unlock ()">
1313
+ <a name="g-mutex-unlock"></a><h3>g_mutex_unlock ()</h3>
1314
+ <pre class="programlisting"><span class="returnvalue">void</span> g_mutex_unlock (<em class="parameter"><code><a class="link" href="glib-Threads.html#GMutex" title="GMutex"><span class="type">GMutex</span></a> *mutex</code></em>);</pre>
1315
+ <p>
1316
+ Unlocks <em class="parameter"><code>mutex</code></em>. If another thread is blocked in a <a class="link" href="glib-Threads.html#g-mutex-lock" title="g_mutex_lock ()"><code class="function">g_mutex_lock()</code></a>
1317
+ call for <em class="parameter"><code>mutex</code></em>, it will be woken and can lock <em class="parameter"><code>mutex</code></em> itself.
1318
+ </p>
1319
+ <p>
1320
+ This function can be used even if <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a> has not yet been
1321
+ called, and, in that case, will do nothing.
1322
+ </p>
1323
+ <div class="variablelist"><table border="0">
1324
+ <col align="left" valign="top">
1325
+ <tbody><tr>
1326
+ <td><p><span class="term"><em class="parameter"><code>mutex</code></em> :</span></p></td>
1327
+ <td>a <a class="link" href="glib-Threads.html#GMutex" title="GMutex"><span class="type">GMutex</span></a>.
1328
+ </td>
1329
+ </tr></tbody>
1330
+ </table></div>
1331
+ </div>
1332
+ <hr>
1333
+ <div class="refsect2" title="g_mutex_free ()">
1334
+ <a name="g-mutex-free"></a><h3>g_mutex_free ()</h3>
1335
+ <pre class="programlisting"><span class="returnvalue">void</span> g_mutex_free (<em class="parameter"><code><a class="link" href="glib-Threads.html#GMutex" title="GMutex"><span class="type">GMutex</span></a> *mutex</code></em>);</pre>
1336
+ <p>
1337
+ Destroys <em class="parameter"><code>mutex</code></em>.
1338
+ </p>
1339
+ <p>
1340
+ </p>
1341
+ <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
1342
+ <h3 class="title">Note</h3>
1343
+ <p>Calling <a class="link" href="glib-Threads.html#g-mutex-free" title="g_mutex_free ()"><code class="function">g_mutex_free()</code></a> on a locked mutex may result in
1344
+ undefined behaviour.</p>
1345
+ </div>
1346
+ <p>
1347
+ </p>
1348
+ <div class="variablelist"><table border="0">
1349
+ <col align="left" valign="top">
1350
+ <tbody><tr>
1351
+ <td><p><span class="term"><em class="parameter"><code>mutex</code></em> :</span></p></td>
1352
+ <td>a <a class="link" href="glib-Threads.html#GMutex" title="GMutex"><span class="type">GMutex</span></a>.
1353
+ </td>
1354
+ </tr></tbody>
1355
+ </table></div>
1356
+ </div>
1357
+ <hr>
1358
+ <div class="refsect2" title="GStaticMutex">
1359
+ <a name="GStaticMutex"></a><h3>GStaticMutex</h3>
1360
+ <pre class="programlisting">typedef struct _GStaticMutex GStaticMutex;</pre>
1361
+ <p>
1362
+ A <a class="link" href="glib-Threads.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a> works like a <a class="link" href="glib-Threads.html#GMutex" title="GMutex"><span class="type">GMutex</span></a>, but it has one significant
1363
+ advantage. It doesn't need to be created at run-time like a <a class="link" href="glib-Threads.html#GMutex" title="GMutex"><span class="type">GMutex</span></a>,
1364
+ but can be defined at compile-time. Here is a shorter, easier and
1365
+ safer version of our <code class="function"><code class="function">give_me_next_number()</code></code>
1366
+ example:
1367
+ </p>
1368
+ <p>
1369
+ </p>
1370
+ <div class="example">
1371
+ <a name="id606617"></a><p class="title"><b>Example 5. 
1372
+ Using <span class="structname">GStaticMutex</span>
1373
+ to simplify thread-safe programming
1374
+ </b></p>
1375
+ <div class="example-contents">
1376
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
1377
+ <tbody>
1378
+ <tr>
1379
+ <td class="listing_lines" align="right"><pre>1
1380
+ 2
1381
+ 3
1382
+ 4
1383
+ 5
1384
+ 6
1385
+ 7
1386
+ 8
1387
+ 9
1388
+ 10
1389
+ 11
1390
+ 12
1391
+ 13</pre></td>
1392
+ <td class="listing_code"><pre class="programlisting"><span class="type">int</span>
1393
+ <span class="function">give_me_next_number</span><span class="normal"> </span><span class="symbol">(</span><span class="type">void</span><span class="symbol">)</span>
1394
+ <span class="cbracket">{</span>
1395
+ <span class="normal"> </span><span class="keyword">static</span><span class="normal"> </span><span class="type">int</span><span class="normal"> current_number </span><span class="symbol">=</span><span class="normal"> </span><span class="number">0</span><span class="symbol">;</span>
1396
+ <span class="normal"> </span><span class="type">int</span><span class="normal"> ret_val</span><span class="symbol">;</span>
1397
+ <span class="normal"> </span><span class="keyword">static</span><span class="normal"> </span><span class="usertype">GStaticMutex</span><span class="normal"> mutex </span><span class="symbol">=</span><span class="normal"> <a href="glib-Threads.html#G-STATIC-MUTEX-INIT:CAPS">G_STATIC_MUTEX_INIT</a></span><span class="symbol">;</span>
1398
+
1399
+ <span class="normal"> </span><span class="function"><a href="glib-Threads.html#g-static-mutex-lock">g_static_mutex_lock</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">mutex</span><span class="symbol">);</span>
1400
+ <span class="normal"> ret_val </span><span class="symbol">=</span><span class="normal"> current_number </span><span class="symbol">=</span><span class="normal"> </span><span class="function">calc_next_number</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">current_number</span><span class="symbol">);</span>
1401
+ <span class="normal"> </span><span class="function"><a href="glib-Threads.html#g-static-mutex-unlock">g_static_mutex_unlock</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">mutex</span><span class="symbol">);</span>
1402
+
1403
+ <span class="normal"> </span><span class="keyword">return</span><span class="normal"> ret_val</span><span class="symbol">;</span>
1404
+ <span class="cbracket">}</span></pre></td>
1405
+ </tr>
1406
+ </tbody>
1407
+ </table>
1408
+ </div>
1409
+
1410
+ </div>
1411
+ <p><br class="example-break">
1412
+ </p>
1413
+ <p>
1414
+ Sometimes you would like to dynamically create a mutex. If you don't
1415
+ want to require prior calling to <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a>, because your code
1416
+ should also be usable in non-threaded programs, you are not able to
1417
+ use <a class="link" href="glib-Threads.html#g-mutex-new" title="g_mutex_new ()"><code class="function">g_mutex_new()</code></a> and thus <a class="link" href="glib-Threads.html#GMutex" title="GMutex"><span class="type">GMutex</span></a>, as that requires a prior call to
1418
+ <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a>. In theses cases you can also use a <a class="link" href="glib-Threads.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a>.
1419
+ It must be initialized with <a class="link" href="glib-Threads.html#g-static-mutex-init" title="g_static_mutex_init ()"><code class="function">g_static_mutex_init()</code></a> before using it
1420
+ and freed with with <a class="link" href="glib-Threads.html#g-static-mutex-free" title="g_static_mutex_free ()"><code class="function">g_static_mutex_free()</code></a> when not needed anymore to
1421
+ free up any allocated resources.
1422
+ </p>
1423
+ <p>
1424
+ Even though <a class="link" href="glib-Threads.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a> is not opaque, it should only be used with
1425
+ the following functions, as it is defined differently on different
1426
+ platforms.
1427
+ </p>
1428
+ <p>
1429
+ All of the <code class="function">g_static_mutex_*</code> functions apart
1430
+ from <code class="function">g_static_mutex_get_mutex</code> can also be used
1431
+ even if <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a> has not yet been called. Then they do
1432
+ nothing, apart from <code class="function">g_static_mutex_trylock</code>,
1433
+ which does nothing but returning <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a>.
1434
+ </p>
1435
+ <p>
1436
+ </p>
1437
+ <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
1438
+ <h3 class="title">Note</h3>
1439
+ <p>All of the <code class="function">g_static_mutex_*</code>
1440
+ functions are actually macros. Apart from taking their addresses, you
1441
+ can however use them as if they were functions.</p>
1442
+ </div>
1443
+ <p>
1444
+ </p>
1445
+ </div>
1446
+ <hr>
1447
+ <div class="refsect2" title="G_STATIC_MUTEX_INIT">
1448
+ <a name="G-STATIC-MUTEX-INIT:CAPS"></a><h3>G_STATIC_MUTEX_INIT</h3>
1449
+ <pre class="programlisting">#define G_STATIC_MUTEX_INIT
1450
+ </pre>
1451
+ <p>
1452
+ A <a class="link" href="glib-Threads.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a> must be initialized with this macro, before it can
1453
+ be used. This macro can used be to initialize a variable, but it
1454
+ cannot be assigned to a variable. In that case you have to use
1455
+ <a class="link" href="glib-Threads.html#g-static-mutex-init" title="g_static_mutex_init ()"><code class="function">g_static_mutex_init()</code></a>.
1456
+ </p>
1457
+ <p>
1458
+ </p>
1459
+ <div class="informalexample">
1460
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
1461
+ <tbody>
1462
+ <tr>
1463
+ <td class="listing_lines" align="right"><pre>1</pre></td>
1464
+ <td class="listing_code"><pre class="programlisting"><span class="usertype">GStaticMutex</span><span class="normal"> my_mutex </span><span class="symbol">=</span><span class="normal"> <a href="glib-Threads.html#G-STATIC-MUTEX-INIT:CAPS">G_STATIC_MUTEX_INIT</a></span><span class="symbol">;</span></pre></td>
1465
+ </tr>
1466
+ </tbody>
1467
+ </table>
1468
+ </div>
1469
+
1470
+ <p>
1471
+ </p>
1472
+ </div>
1473
+ <hr>
1474
+ <div class="refsect2" title="g_static_mutex_init ()">
1475
+ <a name="g-static-mutex-init"></a><h3>g_static_mutex_init ()</h3>
1476
+ <pre class="programlisting"><span class="returnvalue">void</span> g_static_mutex_init (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a> *mutex</code></em>);</pre>
1477
+ <p>
1478
+ Initializes <em class="parameter"><code>mutex</code></em>. Alternatively you can initialize it with
1479
+ <a class="link" href="glib-Threads.html#G-STATIC-MUTEX-INIT:CAPS" title="G_STATIC_MUTEX_INIT"><span class="type">G_STATIC_MUTEX_INIT</span></a>.
1480
+ </p>
1481
+ <div class="variablelist"><table border="0">
1482
+ <col align="left" valign="top">
1483
+ <tbody><tr>
1484
+ <td><p><span class="term"><em class="parameter"><code>mutex</code></em> :</span></p></td>
1485
+ <td>a <a class="link" href="glib-Threads.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a> to be initialized.
1486
+ </td>
1487
+ </tr></tbody>
1488
+ </table></div>
1489
+ </div>
1490
+ <hr>
1491
+ <div class="refsect2" title="g_static_mutex_lock ()">
1492
+ <a name="g-static-mutex-lock"></a><h3>g_static_mutex_lock ()</h3>
1493
+ <pre class="programlisting"><span class="returnvalue">void</span> g_static_mutex_lock (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a> *mutex</code></em>);</pre>
1494
+ <p>
1495
+ Works like <a class="link" href="glib-Threads.html#g-mutex-lock" title="g_mutex_lock ()"><code class="function">g_mutex_lock()</code></a>, but for a <a class="link" href="glib-Threads.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a>.
1496
+ </p>
1497
+ <div class="variablelist"><table border="0">
1498
+ <col align="left" valign="top">
1499
+ <tbody><tr>
1500
+ <td><p><span class="term"><em class="parameter"><code>mutex</code></em> :</span></p></td>
1501
+ <td>a <a class="link" href="glib-Threads.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a>.
1502
+ </td>
1503
+ </tr></tbody>
1504
+ </table></div>
1505
+ </div>
1506
+ <hr>
1507
+ <div class="refsect2" title="g_static_mutex_trylock ()">
1508
+ <a name="g-static-mutex-trylock"></a><h3>g_static_mutex_trylock ()</h3>
1509
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_static_mutex_trylock (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a> *mutex</code></em>);</pre>
1510
+ <p>
1511
+ Works like <a class="link" href="glib-Threads.html#g-mutex-trylock" title="g_mutex_trylock ()"><code class="function">g_mutex_trylock()</code></a>, but for a <a class="link" href="glib-Threads.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a>.
1512
+ </p>
1513
+ <div class="variablelist"><table border="0">
1514
+ <col align="left" valign="top">
1515
+ <tbody>
1516
+ <tr>
1517
+ <td><p><span class="term"><em class="parameter"><code>mutex</code></em> :</span></p></td>
1518
+ <td>a <a class="link" href="glib-Threads.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a>.
1519
+ </td>
1520
+ </tr>
1521
+ <tr>
1522
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1523
+ <td>
1524
+ <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-Threads.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a> could be locked.
1525
+ </td>
1526
+ </tr>
1527
+ </tbody>
1528
+ </table></div>
1529
+ </div>
1530
+ <hr>
1531
+ <div class="refsect2" title="g_static_mutex_unlock ()">
1532
+ <a name="g-static-mutex-unlock"></a><h3>g_static_mutex_unlock ()</h3>
1533
+ <pre class="programlisting"><span class="returnvalue">void</span> g_static_mutex_unlock (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a> *mutex</code></em>);</pre>
1534
+ <p>
1535
+ Works like <a class="link" href="glib-Threads.html#g-mutex-unlock" title="g_mutex_unlock ()"><code class="function">g_mutex_unlock()</code></a>, but for a <a class="link" href="glib-Threads.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a>.
1536
+ </p>
1537
+ <div class="variablelist"><table border="0">
1538
+ <col align="left" valign="top">
1539
+ <tbody><tr>
1540
+ <td><p><span class="term"><em class="parameter"><code>mutex</code></em> :</span></p></td>
1541
+ <td>a <a class="link" href="glib-Threads.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a>.
1542
+ </td>
1543
+ </tr></tbody>
1544
+ </table></div>
1545
+ </div>
1546
+ <hr>
1547
+ <div class="refsect2" title="g_static_mutex_get_mutex ()">
1548
+ <a name="g-static-mutex-get-mutex"></a><h3>g_static_mutex_get_mutex ()</h3>
1549
+ <pre class="programlisting"><a class="link" href="glib-Threads.html#GMutex" title="GMutex"><span class="returnvalue">GMutex</span></a> * g_static_mutex_get_mutex (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a> *mutex</code></em>);</pre>
1550
+ <p>
1551
+ For some operations (like <a class="link" href="glib-Threads.html#g-cond-wait" title="g_cond_wait ()"><code class="function">g_cond_wait()</code></a>) you must have a <a class="link" href="glib-Threads.html#GMutex" title="GMutex"><span class="type">GMutex</span></a>
1552
+ instead of a <a class="link" href="glib-Threads.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a>. This function will return the
1553
+ corresponding <a class="link" href="glib-Threads.html#GMutex" title="GMutex"><span class="type">GMutex</span></a> for <em class="parameter"><code>mutex</code></em>.
1554
+ </p>
1555
+ <div class="variablelist"><table border="0">
1556
+ <col align="left" valign="top">
1557
+ <tbody>
1558
+ <tr>
1559
+ <td><p><span class="term"><em class="parameter"><code>mutex</code></em> :</span></p></td>
1560
+ <td>a <a class="link" href="glib-Threads.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a>.
1561
+ </td>
1562
+ </tr>
1563
+ <tr>
1564
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1565
+ <td>the <a class="link" href="glib-Threads.html#GMutex" title="GMutex"><span class="type">GMutex</span></a> corresponding to <em class="parameter"><code>mutex</code></em>.
1566
+ </td>
1567
+ </tr>
1568
+ </tbody>
1569
+ </table></div>
1570
+ </div>
1571
+ <hr>
1572
+ <div class="refsect2" title="g_static_mutex_free ()">
1573
+ <a name="g-static-mutex-free"></a><h3>g_static_mutex_free ()</h3>
1574
+ <pre class="programlisting"><span class="returnvalue">void</span> g_static_mutex_free (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a> *mutex</code></em>);</pre>
1575
+ <p>
1576
+ Releases all resources allocated to <em class="parameter"><code>mutex</code></em>.
1577
+ </p>
1578
+ <p>
1579
+ You don't have to call this functions for a <a class="link" href="glib-Threads.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a> with an
1580
+ unbounded lifetime, i.e. objects declared 'static', but if you have
1581
+ a <a class="link" href="glib-Threads.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a> as a member of a structure and the structure is
1582
+ freed, you should also free the <a class="link" href="glib-Threads.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a>.
1583
+ </p>
1584
+ <p>
1585
+ </p>
1586
+ <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
1587
+ <h3 class="title">Note</h3>
1588
+ <p>Calling <a class="link" href="glib-Threads.html#g-static-mutex-free" title="g_static_mutex_free ()"><code class="function">g_static_mutex_free()</code></a> on a locked mutex may
1589
+ result in undefined behaviour.</p>
1590
+ </div>
1591
+ <p>
1592
+ </p>
1593
+ <div class="variablelist"><table border="0">
1594
+ <col align="left" valign="top">
1595
+ <tbody><tr>
1596
+ <td><p><span class="term"><em class="parameter"><code>mutex</code></em> :</span></p></td>
1597
+ <td>a <a class="link" href="glib-Threads.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a> to be freed.
1598
+ </td>
1599
+ </tr></tbody>
1600
+ </table></div>
1601
+ </div>
1602
+ <hr>
1603
+ <div class="refsect2" title="G_LOCK_DEFINE()">
1604
+ <a name="G-LOCK-DEFINE:CAPS"></a><h3>G_LOCK_DEFINE()</h3>
1605
+ <pre class="programlisting">#define G_LOCK_DEFINE(name)</pre>
1606
+ <p>
1607
+ The <code class="literal">G_LOCK_</code>* macros provide a convenient interface to <a class="link" href="glib-Threads.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a>
1608
+ with the advantage that they will expand to nothing in programs
1609
+ compiled against a thread-disabled GLib, saving code and memory
1610
+ there. <a class="link" href="glib-Threads.html#G-LOCK-DEFINE:CAPS" title="G_LOCK_DEFINE()"><span class="type">G_LOCK_DEFINE</span></a> defines a lock. It can appear anywhere
1611
+ variable definitions may appear in programs, i.e. in the first block
1612
+ of a function or outside of functions. The <em class="parameter"><code>name</code></em> parameter will be
1613
+ mangled to get the name of the <a class="link" href="glib-Threads.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a>. This means that you
1614
+ can use names of existing variables as the parameter - e.g. the name
1615
+ of the variable you intent to protect with the lock. Look at our
1616
+ <code class="function"><code class="function">give_me_next_number()</code></code> example using the
1617
+ <code class="literal">G_LOCK_</code>* macros:
1618
+ </p>
1619
+ <p>
1620
+ </p>
1621
+ <div class="example">
1622
+ <a name="id607667"></a><p class="title"><b>Example 6. Using the <code class="literal">G_LOCK_</code>* convenience macros</b></p>
1623
+ <div class="example-contents">
1624
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
1625
+ <tbody>
1626
+ <tr>
1627
+ <td class="listing_lines" align="right"><pre>1
1628
+ 2
1629
+ 3
1630
+ 4
1631
+ 5
1632
+ 6
1633
+ 7
1634
+ 8
1635
+ 9
1636
+ 10
1637
+ 11
1638
+ 12
1639
+ 13
1640
+ 14</pre></td>
1641
+ <td class="listing_code"><pre class="programlisting"><span class="function"><a href="glib-Threads.html#G-LOCK-DEFINE:CAPS">G_LOCK_DEFINE</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">current_number</span><span class="symbol">);</span>
1642
+
1643
+ <span class="type">int</span>
1644
+ <span class="function">give_me_next_number</span><span class="normal"> </span><span class="symbol">(</span><span class="type">void</span><span class="symbol">)</span>
1645
+ <span class="cbracket">{</span>
1646
+ <span class="normal"> </span><span class="keyword">static</span><span class="normal"> </span><span class="type">int</span><span class="normal"> current_number </span><span class="symbol">=</span><span class="normal"> </span><span class="number">0</span><span class="symbol">;</span>
1647
+ <span class="normal"> </span><span class="type">int</span><span class="normal"> ret_val</span><span class="symbol">;</span>
1648
+
1649
+ <span class="normal"> </span><span class="function"><a href="glib-Threads.html#G-LOCK:CAPS">G_LOCK</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">current_number</span><span class="symbol">);</span>
1650
+ <span class="normal"> ret_val </span><span class="symbol">=</span><span class="normal"> current_number </span><span class="symbol">=</span><span class="normal"> </span><span class="function">calc_next_number</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">current_number</span><span class="symbol">);</span>
1651
+ <span class="normal"> </span><span class="function"><a href="glib-Threads.html#G-UNLOCK:CAPS">G_UNLOCK</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">current_number</span><span class="symbol">);</span>
1652
+
1653
+ <span class="normal"> </span><span class="keyword">return</span><span class="normal"> ret_val</span><span class="symbol">;</span>
1654
+ <span class="cbracket">}</span></pre></td>
1655
+ </tr>
1656
+ </tbody>
1657
+ </table>
1658
+ </div>
1659
+
1660
+ </div>
1661
+ <p><br class="example-break">
1662
+ </p>
1663
+ <div class="variablelist"><table border="0">
1664
+ <col align="left" valign="top">
1665
+ <tbody><tr>
1666
+ <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
1667
+ <td>the name of the lock.
1668
+ </td>
1669
+ </tr></tbody>
1670
+ </table></div>
1671
+ </div>
1672
+ <hr>
1673
+ <div class="refsect2" title="G_LOCK_DEFINE_STATIC()">
1674
+ <a name="G-LOCK-DEFINE-STATIC:CAPS"></a><h3>G_LOCK_DEFINE_STATIC()</h3>
1675
+ <pre class="programlisting">#define G_LOCK_DEFINE_STATIC(name)</pre>
1676
+ <p>
1677
+ This works like <a class="link" href="glib-Threads.html#G-LOCK-DEFINE:CAPS" title="G_LOCK_DEFINE()"><span class="type">G_LOCK_DEFINE</span></a>, but it creates a static object.
1678
+ </p>
1679
+ <div class="variablelist"><table border="0">
1680
+ <col align="left" valign="top">
1681
+ <tbody><tr>
1682
+ <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
1683
+ <td>the name of the lock.
1684
+ </td>
1685
+ </tr></tbody>
1686
+ </table></div>
1687
+ </div>
1688
+ <hr>
1689
+ <div class="refsect2" title="G_LOCK_EXTERN()">
1690
+ <a name="G-LOCK-EXTERN:CAPS"></a><h3>G_LOCK_EXTERN()</h3>
1691
+ <pre class="programlisting">#define G_LOCK_EXTERN(name)</pre>
1692
+ <p>
1693
+ This declares a lock, that is defined with <a class="link" href="glib-Threads.html#G-LOCK-DEFINE:CAPS" title="G_LOCK_DEFINE()"><span class="type">G_LOCK_DEFINE</span></a> in another
1694
+ module.
1695
+ </p>
1696
+ <div class="variablelist"><table border="0">
1697
+ <col align="left" valign="top">
1698
+ <tbody><tr>
1699
+ <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
1700
+ <td>the name of the lock.
1701
+ </td>
1702
+ </tr></tbody>
1703
+ </table></div>
1704
+ </div>
1705
+ <hr>
1706
+ <div class="refsect2" title="G_LOCK()">
1707
+ <a name="G-LOCK:CAPS"></a><h3>G_LOCK()</h3>
1708
+ <pre class="programlisting">#define G_LOCK(name)</pre>
1709
+ <p>
1710
+ Works like <a class="link" href="glib-Threads.html#g-mutex-lock" title="g_mutex_lock ()"><code class="function">g_mutex_lock()</code></a>, but for a lock defined with
1711
+ <a class="link" href="glib-Threads.html#G-LOCK-DEFINE:CAPS" title="G_LOCK_DEFINE()"><span class="type">G_LOCK_DEFINE</span></a>.
1712
+ </p>
1713
+ <div class="variablelist"><table border="0">
1714
+ <col align="left" valign="top">
1715
+ <tbody><tr>
1716
+ <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
1717
+ <td>the name of the lock.
1718
+ </td>
1719
+ </tr></tbody>
1720
+ </table></div>
1721
+ </div>
1722
+ <hr>
1723
+ <div class="refsect2" title="G_TRYLOCK()">
1724
+ <a name="G-TRYLOCK:CAPS"></a><h3>G_TRYLOCK()</h3>
1725
+ <pre class="programlisting">#define G_TRYLOCK(name)</pre>
1726
+ <p>
1727
+ Works like <a class="link" href="glib-Threads.html#g-mutex-trylock" title="g_mutex_trylock ()"><code class="function">g_mutex_trylock()</code></a>, but for a lock defined with
1728
+ <a class="link" href="glib-Threads.html#G-LOCK-DEFINE:CAPS" title="G_LOCK_DEFINE()"><span class="type">G_LOCK_DEFINE</span></a>.
1729
+ </p>
1730
+ <div class="variablelist"><table border="0">
1731
+ <col align="left" valign="top">
1732
+ <tbody>
1733
+ <tr>
1734
+ <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
1735
+ <td>the name of the lock.
1736
+ </td>
1737
+ </tr>
1738
+ <tr>
1739
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1740
+ <td>
1741
+ <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a>, if the lock could be locked.
1742
+ </td>
1743
+ </tr>
1744
+ </tbody>
1745
+ </table></div>
1746
+ </div>
1747
+ <hr>
1748
+ <div class="refsect2" title="G_UNLOCK()">
1749
+ <a name="G-UNLOCK:CAPS"></a><h3>G_UNLOCK()</h3>
1750
+ <pre class="programlisting">#define G_UNLOCK(name)</pre>
1751
+ <p>
1752
+ Works like <a class="link" href="glib-Threads.html#g-mutex-unlock" title="g_mutex_unlock ()"><code class="function">g_mutex_unlock()</code></a>, but for a lock defined with
1753
+ <a class="link" href="glib-Threads.html#G-LOCK-DEFINE:CAPS" title="G_LOCK_DEFINE()"><span class="type">G_LOCK_DEFINE</span></a>.
1754
+ </p>
1755
+ <div class="variablelist"><table border="0">
1756
+ <col align="left" valign="top">
1757
+ <tbody><tr>
1758
+ <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
1759
+ <td>the name of the lock.
1760
+ </td>
1761
+ </tr></tbody>
1762
+ </table></div>
1763
+ </div>
1764
+ <hr>
1765
+ <div class="refsect2" title="GStaticRecMutex">
1766
+ <a name="GStaticRecMutex"></a><h3>GStaticRecMutex</h3>
1767
+ <pre class="programlisting">typedef struct {
1768
+ } GStaticRecMutex;
1769
+ </pre>
1770
+ <p>
1771
+ A <a class="link" href="glib-Threads.html#GStaticRecMutex" title="GStaticRecMutex"><span class="type">GStaticRecMutex</span></a> works like a <a class="link" href="glib-Threads.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a>, but it can be locked
1772
+ multiple times by one thread. If you enter it n times, you have to
1773
+ unlock it n times again to let other threads lock it. An exception
1774
+ is the function <a class="link" href="glib-Threads.html#g-static-rec-mutex-unlock-full" title="g_static_rec_mutex_unlock_full ()"><code class="function">g_static_rec_mutex_unlock_full()</code></a>: that allows you to
1775
+ unlock a <a class="link" href="glib-Threads.html#GStaticRecMutex" title="GStaticRecMutex"><span class="type">GStaticRecMutex</span></a> completely returning the depth, (i.e. the
1776
+ number of times this mutex was locked). The depth can later be used
1777
+ to restore the state of the <a class="link" href="glib-Threads.html#GStaticRecMutex" title="GStaticRecMutex"><span class="type">GStaticRecMutex</span></a> by calling
1778
+ <a class="link" href="glib-Threads.html#g-static-rec-mutex-lock-full" title="g_static_rec_mutex_lock_full ()"><code class="function">g_static_rec_mutex_lock_full()</code></a>.
1779
+ </p>
1780
+ <p>
1781
+ Even though <a class="link" href="glib-Threads.html#GStaticRecMutex" title="GStaticRecMutex"><span class="type">GStaticRecMutex</span></a> is not opaque, it should only be used
1782
+ with the following functions.
1783
+ </p>
1784
+ <p>
1785
+ All of the <code class="function">g_static_rec_mutex_*</code> functions can
1786
+ be used even if <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a> has not been called. Then they do
1787
+ nothing, apart from <code class="function">g_static_rec_mutex_trylock</code>,
1788
+ which does nothing but returning <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a>.
1789
+ </p>
1790
+ </div>
1791
+ <hr>
1792
+ <div class="refsect2" title="G_STATIC_REC_MUTEX_INIT">
1793
+ <a name="G-STATIC-REC-MUTEX-INIT:CAPS"></a><h3>G_STATIC_REC_MUTEX_INIT</h3>
1794
+ <pre class="programlisting">#define G_STATIC_REC_MUTEX_INIT { G_STATIC_MUTEX_INIT }
1795
+ </pre>
1796
+ <p>
1797
+ A <a class="link" href="glib-Threads.html#GStaticRecMutex" title="GStaticRecMutex"><span class="type">GStaticRecMutex</span></a> must be initialized with this macro before it can
1798
+ be used. This macro can used be to initialize a variable, but it
1799
+ cannot be assigned to a variable. In that case you have to use
1800
+ <a class="link" href="glib-Threads.html#g-static-rec-mutex-init" title="g_static_rec_mutex_init ()"><code class="function">g_static_rec_mutex_init()</code></a>.
1801
+ </p>
1802
+ <p>
1803
+ </p>
1804
+ <div class="informalexample">
1805
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
1806
+ <tbody>
1807
+ <tr>
1808
+ <td class="listing_lines" align="right"><pre>1</pre></td>
1809
+ <td class="listing_code"><pre class="programlisting"><span class="usertype">GStaticRecMutex</span><span class="normal"> my_mutex </span><span class="symbol">=</span><span class="normal"> <a href="glib-Threads.html#G-STATIC-REC-MUTEX-INIT:CAPS">G_STATIC_REC_MUTEX_INIT</a></span><span class="symbol">;</span></pre></td>
1810
+ </tr>
1811
+ </tbody>
1812
+ </table>
1813
+ </div>
1814
+
1815
+ <p>
1816
+ </p>
1817
+ </div>
1818
+ <hr>
1819
+ <div class="refsect2" title="g_static_rec_mutex_init ()">
1820
+ <a name="g-static-rec-mutex-init"></a><h3>g_static_rec_mutex_init ()</h3>
1821
+ <pre class="programlisting"><span class="returnvalue">void</span> g_static_rec_mutex_init (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticRecMutex" title="GStaticRecMutex"><span class="type">GStaticRecMutex</span></a> *mutex</code></em>);</pre>
1822
+ <p>
1823
+ A <a class="link" href="glib-Threads.html#GStaticRecMutex" title="GStaticRecMutex"><span class="type">GStaticRecMutex</span></a> must be initialized with this function before it
1824
+ can be used. Alternatively you can initialize it with
1825
+ <a class="link" href="glib-Threads.html#G-STATIC-REC-MUTEX-INIT:CAPS" title="G_STATIC_REC_MUTEX_INIT"><span class="type">G_STATIC_REC_MUTEX_INIT</span></a>.
1826
+ </p>
1827
+ <div class="variablelist"><table border="0">
1828
+ <col align="left" valign="top">
1829
+ <tbody><tr>
1830
+ <td><p><span class="term"><em class="parameter"><code>mutex</code></em> :</span></p></td>
1831
+ <td>a <a class="link" href="glib-Threads.html#GStaticRecMutex" title="GStaticRecMutex"><span class="type">GStaticRecMutex</span></a> to be initialized.
1832
+ </td>
1833
+ </tr></tbody>
1834
+ </table></div>
1835
+ </div>
1836
+ <hr>
1837
+ <div class="refsect2" title="g_static_rec_mutex_lock ()">
1838
+ <a name="g-static-rec-mutex-lock"></a><h3>g_static_rec_mutex_lock ()</h3>
1839
+ <pre class="programlisting"><span class="returnvalue">void</span> g_static_rec_mutex_lock (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticRecMutex" title="GStaticRecMutex"><span class="type">GStaticRecMutex</span></a> *mutex</code></em>);</pre>
1840
+ <p>
1841
+ Locks <em class="parameter"><code>mutex</code></em>. If <em class="parameter"><code>mutex</code></em> is already locked by another thread, the
1842
+ current thread will block until <em class="parameter"><code>mutex</code></em> is unlocked by the other
1843
+ thread. If <em class="parameter"><code>mutex</code></em> is already locked by the calling thread, this
1844
+ functions increases the depth of <em class="parameter"><code>mutex</code></em> and returns immediately.
1845
+ </p>
1846
+ <div class="variablelist"><table border="0">
1847
+ <col align="left" valign="top">
1848
+ <tbody><tr>
1849
+ <td><p><span class="term"><em class="parameter"><code>mutex</code></em> :</span></p></td>
1850
+ <td>a <a class="link" href="glib-Threads.html#GStaticRecMutex" title="GStaticRecMutex"><span class="type">GStaticRecMutex</span></a> to lock.
1851
+ </td>
1852
+ </tr></tbody>
1853
+ </table></div>
1854
+ </div>
1855
+ <hr>
1856
+ <div class="refsect2" title="g_static_rec_mutex_trylock ()">
1857
+ <a name="g-static-rec-mutex-trylock"></a><h3>g_static_rec_mutex_trylock ()</h3>
1858
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_static_rec_mutex_trylock (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticRecMutex" title="GStaticRecMutex"><span class="type">GStaticRecMutex</span></a> *mutex</code></em>);</pre>
1859
+ <p>
1860
+ Tries to lock <em class="parameter"><code>mutex</code></em>. If <em class="parameter"><code>mutex</code></em> is already locked by another thread,
1861
+ it immediately returns <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a>. Otherwise it locks <em class="parameter"><code>mutex</code></em> and returns
1862
+ <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a>. If <em class="parameter"><code>mutex</code></em> is already locked by the calling thread, this
1863
+ functions increases the depth of <em class="parameter"><code>mutex</code></em> and immediately returns
1864
+ <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a>.
1865
+ </p>
1866
+ <div class="variablelist"><table border="0">
1867
+ <col align="left" valign="top">
1868
+ <tbody>
1869
+ <tr>
1870
+ <td><p><span class="term"><em class="parameter"><code>mutex</code></em> :</span></p></td>
1871
+ <td>a <a class="link" href="glib-Threads.html#GStaticRecMutex" title="GStaticRecMutex"><span class="type">GStaticRecMutex</span></a> to lock.
1872
+ </td>
1873
+ </tr>
1874
+ <tr>
1875
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1876
+ <td>
1877
+ <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a>, if <em class="parameter"><code>mutex</code></em> could be locked.
1878
+ </td>
1879
+ </tr>
1880
+ </tbody>
1881
+ </table></div>
1882
+ </div>
1883
+ <hr>
1884
+ <div class="refsect2" title="g_static_rec_mutex_unlock ()">
1885
+ <a name="g-static-rec-mutex-unlock"></a><h3>g_static_rec_mutex_unlock ()</h3>
1886
+ <pre class="programlisting"><span class="returnvalue">void</span> g_static_rec_mutex_unlock (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticRecMutex" title="GStaticRecMutex"><span class="type">GStaticRecMutex</span></a> *mutex</code></em>);</pre>
1887
+ <p>
1888
+ Unlocks <em class="parameter"><code>mutex</code></em>. Another thread will be allowed to lock <em class="parameter"><code>mutex</code></em> only
1889
+ when it has been unlocked as many times as it had been locked
1890
+ before. If <em class="parameter"><code>mutex</code></em> is completely unlocked and another thread is
1891
+ blocked in a <a class="link" href="glib-Threads.html#g-static-rec-mutex-lock" title="g_static_rec_mutex_lock ()"><code class="function">g_static_rec_mutex_lock()</code></a> call for <em class="parameter"><code>mutex</code></em>, it will be
1892
+ woken and can lock <em class="parameter"><code>mutex</code></em> itself.
1893
+ </p>
1894
+ <div class="variablelist"><table border="0">
1895
+ <col align="left" valign="top">
1896
+ <tbody><tr>
1897
+ <td><p><span class="term"><em class="parameter"><code>mutex</code></em> :</span></p></td>
1898
+ <td>a <a class="link" href="glib-Threads.html#GStaticRecMutex" title="GStaticRecMutex"><span class="type">GStaticRecMutex</span></a> to unlock.
1899
+ </td>
1900
+ </tr></tbody>
1901
+ </table></div>
1902
+ </div>
1903
+ <hr>
1904
+ <div class="refsect2" title="g_static_rec_mutex_lock_full ()">
1905
+ <a name="g-static-rec-mutex-lock-full"></a><h3>g_static_rec_mutex_lock_full ()</h3>
1906
+ <pre class="programlisting"><span class="returnvalue">void</span> g_static_rec_mutex_lock_full (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticRecMutex" title="GStaticRecMutex"><span class="type">GStaticRecMutex</span></a> *mutex</code></em>,
1907
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="type">guint</span></a> depth</code></em>);</pre>
1908
+ <p>
1909
+ Works like calling <a class="link" href="glib-Threads.html#g-static-rec-mutex-lock" title="g_static_rec_mutex_lock ()"><code class="function">g_static_rec_mutex_lock()</code></a> for <em class="parameter"><code>mutex</code></em> <em class="parameter"><code>depth</code></em> times.
1910
+ </p>
1911
+ <div class="variablelist"><table border="0">
1912
+ <col align="left" valign="top">
1913
+ <tbody>
1914
+ <tr>
1915
+ <td><p><span class="term"><em class="parameter"><code>mutex</code></em> :</span></p></td>
1916
+ <td>a <a class="link" href="glib-Threads.html#GStaticRecMutex" title="GStaticRecMutex"><span class="type">GStaticRecMutex</span></a> to lock.
1917
+ </td>
1918
+ </tr>
1919
+ <tr>
1920
+ <td><p><span class="term"><em class="parameter"><code>depth</code></em> :</span></p></td>
1921
+ <td>number of times this mutex has to be unlocked to be
1922
+ completely unlocked.
1923
+ </td>
1924
+ </tr>
1925
+ </tbody>
1926
+ </table></div>
1927
+ </div>
1928
+ <hr>
1929
+ <div class="refsect2" title="g_static_rec_mutex_unlock_full ()">
1930
+ <a name="g-static-rec-mutex-unlock-full"></a><h3>g_static_rec_mutex_unlock_full ()</h3>
1931
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="returnvalue">guint</span></a> g_static_rec_mutex_unlock_full (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticRecMutex" title="GStaticRecMutex"><span class="type">GStaticRecMutex</span></a> *mutex</code></em>);</pre>
1932
+ <p>
1933
+ Completely unlocks <em class="parameter"><code>mutex</code></em>. If another thread is blocked in a
1934
+ <a class="link" href="glib-Threads.html#g-static-rec-mutex-lock" title="g_static_rec_mutex_lock ()"><code class="function">g_static_rec_mutex_lock()</code></a> call for <em class="parameter"><code>mutex</code></em>, it will be woken and can
1935
+ lock <em class="parameter"><code>mutex</code></em> itself. This function returns the number of times that
1936
+ <em class="parameter"><code>mutex</code></em> has been locked by the current thread. To restore the state
1937
+ before the call to <a class="link" href="glib-Threads.html#g-static-rec-mutex-unlock-full" title="g_static_rec_mutex_unlock_full ()"><code class="function">g_static_rec_mutex_unlock_full()</code></a> you can call
1938
+ <a class="link" href="glib-Threads.html#g-static-rec-mutex-lock-full" title="g_static_rec_mutex_lock_full ()"><code class="function">g_static_rec_mutex_lock_full()</code></a> with the depth returned by this
1939
+ function.
1940
+ </p>
1941
+ <div class="variablelist"><table border="0">
1942
+ <col align="left" valign="top">
1943
+ <tbody>
1944
+ <tr>
1945
+ <td><p><span class="term"><em class="parameter"><code>mutex</code></em> :</span></p></td>
1946
+ <td>a <a class="link" href="glib-Threads.html#GStaticRecMutex" title="GStaticRecMutex"><span class="type">GStaticRecMutex</span></a> to completely unlock.
1947
+ </td>
1948
+ </tr>
1949
+ <tr>
1950
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1951
+ <td>number of times <em class="parameter"><code>mutex</code></em> has been locked by the current
1952
+ thread.
1953
+ </td>
1954
+ </tr>
1955
+ </tbody>
1956
+ </table></div>
1957
+ </div>
1958
+ <hr>
1959
+ <div class="refsect2" title="g_static_rec_mutex_free ()">
1960
+ <a name="g-static-rec-mutex-free"></a><h3>g_static_rec_mutex_free ()</h3>
1961
+ <pre class="programlisting"><span class="returnvalue">void</span> g_static_rec_mutex_free (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticRecMutex" title="GStaticRecMutex"><span class="type">GStaticRecMutex</span></a> *mutex</code></em>);</pre>
1962
+ <p>
1963
+ Releases all resources allocated to a <a class="link" href="glib-Threads.html#GStaticRecMutex" title="GStaticRecMutex"><span class="type">GStaticRecMutex</span></a>.
1964
+ </p>
1965
+ <p>
1966
+ You don't have to call this functions for a <a class="link" href="glib-Threads.html#GStaticRecMutex" title="GStaticRecMutex"><span class="type">GStaticRecMutex</span></a> with an
1967
+ unbounded lifetime, i.e. objects declared 'static', but if you have
1968
+ a <a class="link" href="glib-Threads.html#GStaticRecMutex" title="GStaticRecMutex"><span class="type">GStaticRecMutex</span></a> as a member of a structure and the structure is
1969
+ freed, you should also free the <a class="link" href="glib-Threads.html#GStaticRecMutex" title="GStaticRecMutex"><span class="type">GStaticRecMutex</span></a>.
1970
+ </p>
1971
+ <div class="variablelist"><table border="0">
1972
+ <col align="left" valign="top">
1973
+ <tbody><tr>
1974
+ <td><p><span class="term"><em class="parameter"><code>mutex</code></em> :</span></p></td>
1975
+ <td>a <a class="link" href="glib-Threads.html#GStaticRecMutex" title="GStaticRecMutex"><span class="type">GStaticRecMutex</span></a> to be freed.
1976
+ </td>
1977
+ </tr></tbody>
1978
+ </table></div>
1979
+ </div>
1980
+ <hr>
1981
+ <div class="refsect2" title="GStaticRWLock">
1982
+ <a name="GStaticRWLock"></a><h3>GStaticRWLock</h3>
1983
+ <pre class="programlisting">typedef struct {
1984
+ } GStaticRWLock;
1985
+ </pre>
1986
+ <p>
1987
+ The <a class="link" href="glib-Threads.html#GStaticRWLock" title="GStaticRWLock"><span class="type">GStaticRWLock</span></a> struct represents a read-write lock. A read-write
1988
+ lock can be used for protecting data that some portions of code only
1989
+ read from, while others also write. In such situations it is
1990
+ desirable that several readers can read at once, whereas of course
1991
+ only one writer may write at a time. Take a look at the following
1992
+ example:
1993
+ </p>
1994
+ <p>
1995
+ </p>
1996
+ <div class="example">
1997
+ <a name="id609282"></a><p class="title"><b>Example 7. An array with access functions</b></p>
1998
+ <div class="example-contents">
1999
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
2000
+ <tbody>
2001
+ <tr>
2002
+ <td class="listing_lines" align="right"><pre>1
2003
+ 2
2004
+ 3
2005
+ 4
2006
+ 5
2007
+ 6
2008
+ 7
2009
+ 8
2010
+ 9
2011
+ 10
2012
+ 11
2013
+ 12
2014
+ 13
2015
+ 14
2016
+ 15
2017
+ 16
2018
+ 17
2019
+ 18
2020
+ 19
2021
+ 20
2022
+ 21
2023
+ 22
2024
+ 23
2025
+ 24
2026
+ 25
2027
+ 26
2028
+ 27
2029
+ 28
2030
+ 29
2031
+ 30
2032
+ 31
2033
+ 32
2034
+ 33</pre></td>
2035
+ <td class="listing_code"><pre class="programlisting"><span class="usertype">GStaticRWLock</span><span class="normal"> rwlock </span><span class="symbol">=</span><span class="normal"> <a href="glib-Threads.html#G-STATIC-RW-LOCK-INIT:CAPS">G_STATIC_RW_LOCK_INIT</a></span><span class="symbol">;</span>
2036
+ <span class="usertype">GPtrArray</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">array</span><span class="symbol">;</span>
2037
+
2038
+ <span class="normal"><a href="glib-Basic-Types.html#gpointer">gpointer</a></span>
2039
+ <span class="function">my_array_get</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">guint</span><span class="normal"> index</span><span class="symbol">)</span>
2040
+ <span class="cbracket">{</span>
2041
+ <span class="normal"> </span><span class="usertype">gpointer</span><span class="normal"> retval </span><span class="symbol">=</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
2042
+
2043
+ <span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(!</span><span class="normal">array</span><span class="symbol">)</span>
2044
+ <span class="normal"> </span><span class="keyword">return</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
2045
+
2046
+ <span class="normal"> </span><span class="function"><a href="glib-Threads.html#g-static-rw-lock-reader-lock">g_static_rw_lock_reader_lock</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">rwlock</span><span class="symbol">);</span>
2047
+ <span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">index </span><span class="symbol">&lt;</span><span class="normal"> array</span><span class="symbol">-&gt;</span><span class="normal">len</span><span class="symbol">)</span>
2048
+ <span class="normal"> retval </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-Pointer-Arrays.html#g-ptr-array-index">g_ptr_array_index</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">array</span><span class="symbol">,</span><span class="normal"> index</span><span class="symbol">);</span>
2049
+ <span class="normal"> </span><span class="function"><a href="glib-Threads.html#g-static-rw-lock-reader-unlock">g_static_rw_lock_reader_unlock</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">rwlock</span><span class="symbol">);</span>
2050
+
2051
+ <span class="normal"> </span><span class="keyword">return</span><span class="normal"> retval</span><span class="symbol">;</span>
2052
+ <span class="cbracket">}</span>
2053
+
2054
+ <span class="type">void</span>
2055
+ <span class="function">my_array_set</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">guint</span><span class="normal"> index</span><span class="symbol">,</span><span class="normal"> </span><span class="usertype">gpointer</span><span class="normal"> data</span><span class="symbol">)</span>
2056
+ <span class="cbracket">{</span>
2057
+ <span class="normal"> </span><span class="function"><a href="glib-Threads.html#g-static-rw-lock-writer-lock">g_static_rw_lock_writer_lock</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">rwlock</span><span class="symbol">);</span>
2058
+
2059
+ <span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(!</span><span class="normal">array</span><span class="symbol">)</span>
2060
+ <span class="normal"> array </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-Pointer-Arrays.html#g-ptr-array-new">g_ptr_array_new</a></span><span class="normal"> </span><span class="symbol">();</span>
2061
+
2062
+ <span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">index </span><span class="symbol">&gt;=</span><span class="normal"> array</span><span class="symbol">-&gt;</span><span class="normal">len</span><span class="symbol">)</span>
2063
+ <span class="normal"> </span><span class="function"><a href="glib-Pointer-Arrays.html#g-ptr-array-set-size">g_ptr_array_set_size</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">array</span><span class="symbol">,</span><span class="normal"> index</span><span class="symbol">+</span><span class="number">1</span><span class="symbol">);</span>
2064
+ <span class="normal"> </span><span class="function"><a href="glib-Pointer-Arrays.html#g-ptr-array-index">g_ptr_array_index</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">array</span><span class="symbol">,</span><span class="normal"> index</span><span class="symbol">)</span><span class="normal"> </span><span class="symbol">=</span><span class="normal"> data</span><span class="symbol">;</span>
2065
+
2066
+ <span class="normal"> </span><span class="function"><a href="glib-Threads.html#g-static-rw-lock-writer-unlock">g_static_rw_lock_writer_unlock</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">rwlock</span><span class="symbol">);</span>
2067
+ <span class="cbracket">}</span></pre></td>
2068
+ </tr>
2069
+ </tbody>
2070
+ </table>
2071
+ </div>
2072
+
2073
+ </div>
2074
+ <p><br class="example-break">
2075
+ </p>
2076
+ <p>
2077
+ This example shows an array which can be accessed by many readers
2078
+ (the <code class="function"><code class="function">my_array_get()</code></code> function) simultaneously,
2079
+ whereas the writers (the <code class="function"><code class="function">my_array_set()</code></code>
2080
+ function) will only be allowed once at a time and only if no readers
2081
+ currently access the array. This is because of the potentially
2082
+ dangerous resizing of the array. Using these functions is fully
2083
+ multi-thread safe now.
2084
+ </p>
2085
+ <p>
2086
+ Most of the time, writers should have precedence over readers. That
2087
+ means, for this implementation, that as soon as a writer wants to
2088
+ lock the data, no other reader is allowed to lock the data, whereas,
2089
+ of course, the readers that already have locked the data are allowed
2090
+ to finish their operation. As soon as the last reader unlocks the
2091
+ data, the writer will lock it.
2092
+ </p>
2093
+ <p>
2094
+ Even though <a class="link" href="glib-Threads.html#GStaticRWLock" title="GStaticRWLock"><span class="type">GStaticRWLock</span></a> is not opaque, it should only be used
2095
+ with the following functions.
2096
+ </p>
2097
+ <p>
2098
+ All of the <code class="function">g_static_rw_lock_*</code> functions can be
2099
+ used even if <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a> has not been called. Then they do
2100
+ nothing, apart from <code class="function">g_static_rw_lock_*_trylock</code>,
2101
+ which does nothing but returning <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a>.
2102
+ </p>
2103
+ <p>
2104
+ </p>
2105
+ <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
2106
+ <h3 class="title">Note</h3>
2107
+ <p>A read-write lock has a higher overhead than a mutex. For
2108
+ example, both <a class="link" href="glib-Threads.html#g-static-rw-lock-reader-lock" title="g_static_rw_lock_reader_lock ()"><code class="function">g_static_rw_lock_reader_lock()</code></a> and
2109
+ <a class="link" href="glib-Threads.html#g-static-rw-lock-reader-unlock" title="g_static_rw_lock_reader_unlock ()"><code class="function">g_static_rw_lock_reader_unlock()</code></a> have to lock and unlock a
2110
+ <a class="link" href="glib-Threads.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a>, so it takes at least twice the time to lock and unlock
2111
+ a <a class="link" href="glib-Threads.html#GStaticRWLock" title="GStaticRWLock"><span class="type">GStaticRWLock</span></a> that it does to lock and unlock a <a class="link" href="glib-Threads.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a>. So
2112
+ only data structures that are accessed by multiple readers, and which
2113
+ keep the lock for a considerable time justify a <a class="link" href="glib-Threads.html#GStaticRWLock" title="GStaticRWLock"><span class="type">GStaticRWLock</span></a>. The
2114
+ above example most probably would fare better with a
2115
+ <a class="link" href="glib-Threads.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a>.</p>
2116
+ </div>
2117
+ <p>
2118
+ </p>
2119
+ </div>
2120
+ <hr>
2121
+ <div class="refsect2" title="G_STATIC_RW_LOCK_INIT">
2122
+ <a name="G-STATIC-RW-LOCK-INIT:CAPS"></a><h3>G_STATIC_RW_LOCK_INIT</h3>
2123
+ <pre class="programlisting">#define G_STATIC_RW_LOCK_INIT { G_STATIC_MUTEX_INIT, NULL, NULL, 0, FALSE, 0, 0 }
2124
+ </pre>
2125
+ <p>
2126
+ A <a class="link" href="glib-Threads.html#GStaticRWLock" title="GStaticRWLock"><span class="type">GStaticRWLock</span></a> must be initialized with this macro before it can
2127
+ be used. This macro can used be to initialize a variable, but it
2128
+ cannot be assigned to a variable. In that case you have to use
2129
+ <a class="link" href="glib-Threads.html#g-static-rw-lock-init" title="g_static_rw_lock_init ()"><code class="function">g_static_rw_lock_init()</code></a>.
2130
+ </p>
2131
+ <p>
2132
+ </p>
2133
+ <div class="informalexample">
2134
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
2135
+ <tbody>
2136
+ <tr>
2137
+ <td class="listing_lines" align="right"><pre>1</pre></td>
2138
+ <td class="listing_code"><pre class="programlisting"><span class="usertype">GStaticRWLock</span><span class="normal"> my_lock </span><span class="symbol">=</span><span class="normal"> <a href="glib-Threads.html#G-STATIC-RW-LOCK-INIT:CAPS">G_STATIC_RW_LOCK_INIT</a></span><span class="symbol">;</span></pre></td>
2139
+ </tr>
2140
+ </tbody>
2141
+ </table>
2142
+ </div>
2143
+
2144
+ <p>
2145
+ </p>
2146
+ </div>
2147
+ <hr>
2148
+ <div class="refsect2" title="g_static_rw_lock_init ()">
2149
+ <a name="g-static-rw-lock-init"></a><h3>g_static_rw_lock_init ()</h3>
2150
+ <pre class="programlisting"><span class="returnvalue">void</span> g_static_rw_lock_init (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticRWLock" title="GStaticRWLock"><span class="type">GStaticRWLock</span></a> *lock</code></em>);</pre>
2151
+ <p>
2152
+ A <a class="link" href="glib-Threads.html#GStaticRWLock" title="GStaticRWLock"><span class="type">GStaticRWLock</span></a> must be initialized with this function before it
2153
+ can be used. Alternatively you can initialize it with
2154
+ <a class="link" href="glib-Threads.html#G-STATIC-RW-LOCK-INIT:CAPS" title="G_STATIC_RW_LOCK_INIT"><span class="type">G_STATIC_RW_LOCK_INIT</span></a>.
2155
+ </p>
2156
+ <div class="variablelist"><table border="0">
2157
+ <col align="left" valign="top">
2158
+ <tbody><tr>
2159
+ <td><p><span class="term"><em class="parameter"><code>lock</code></em> :</span></p></td>
2160
+ <td>a <a class="link" href="glib-Threads.html#GStaticRWLock" title="GStaticRWLock"><span class="type">GStaticRWLock</span></a> to be initialized.
2161
+ </td>
2162
+ </tr></tbody>
2163
+ </table></div>
2164
+ </div>
2165
+ <hr>
2166
+ <div class="refsect2" title="g_static_rw_lock_reader_lock ()">
2167
+ <a name="g-static-rw-lock-reader-lock"></a><h3>g_static_rw_lock_reader_lock ()</h3>
2168
+ <pre class="programlisting"><span class="returnvalue">void</span> g_static_rw_lock_reader_lock (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticRWLock" title="GStaticRWLock"><span class="type">GStaticRWLock</span></a> *lock</code></em>);</pre>
2169
+ <p>
2170
+ Locks <em class="parameter"><code>lock</code></em> for reading. There may be unlimited concurrent locks for
2171
+ reading of a <a class="link" href="glib-Threads.html#GStaticRWLock" title="GStaticRWLock"><span class="type">GStaticRWLock</span></a> at the same time. If <em class="parameter"><code>lock</code></em> is already
2172
+ locked for writing by another thread or if another thread is already
2173
+ waiting to lock <em class="parameter"><code>lock</code></em> for writing, this function will block until
2174
+ <em class="parameter"><code>lock</code></em> is unlocked by the other writing thread and no other writing
2175
+ threads want to lock <em class="parameter"><code>lock</code></em>. This lock has to be unlocked by
2176
+ <a class="link" href="glib-Threads.html#g-static-rw-lock-reader-unlock" title="g_static_rw_lock_reader_unlock ()"><code class="function">g_static_rw_lock_reader_unlock()</code></a>.
2177
+ </p>
2178
+ <p>
2179
+ <a class="link" href="glib-Threads.html#GStaticRWLock" title="GStaticRWLock"><span class="type">GStaticRWLock</span></a> is not recursive. It might seem to be possible to
2180
+ recursively lock for reading, but that can result in a deadlock, due
2181
+ to writer preference.
2182
+ </p>
2183
+ <div class="variablelist"><table border="0">
2184
+ <col align="left" valign="top">
2185
+ <tbody><tr>
2186
+ <td><p><span class="term"><em class="parameter"><code>lock</code></em> :</span></p></td>
2187
+ <td>a <a class="link" href="glib-Threads.html#GStaticRWLock" title="GStaticRWLock"><span class="type">GStaticRWLock</span></a> to lock for reading.
2188
+ </td>
2189
+ </tr></tbody>
2190
+ </table></div>
2191
+ </div>
2192
+ <hr>
2193
+ <div class="refsect2" title="g_static_rw_lock_reader_trylock ()">
2194
+ <a name="g-static-rw-lock-reader-trylock"></a><h3>g_static_rw_lock_reader_trylock ()</h3>
2195
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_static_rw_lock_reader_trylock (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticRWLock" title="GStaticRWLock"><span class="type">GStaticRWLock</span></a> *lock</code></em>);</pre>
2196
+ <p>
2197
+ Tries to lock <em class="parameter"><code>lock</code></em> for reading. If <em class="parameter"><code>lock</code></em> is already locked for
2198
+ writing by another thread or if another thread is already waiting to
2199
+ lock <em class="parameter"><code>lock</code></em> for writing, immediately returns <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a>. Otherwise locks
2200
+ <em class="parameter"><code>lock</code></em> for reading and returns <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a>. This lock has to be unlocked by
2201
+ <a class="link" href="glib-Threads.html#g-static-rw-lock-reader-unlock" title="g_static_rw_lock_reader_unlock ()"><code class="function">g_static_rw_lock_reader_unlock()</code></a>.
2202
+ </p>
2203
+ <div class="variablelist"><table border="0">
2204
+ <col align="left" valign="top">
2205
+ <tbody>
2206
+ <tr>
2207
+ <td><p><span class="term"><em class="parameter"><code>lock</code></em> :</span></p></td>
2208
+ <td>a <a class="link" href="glib-Threads.html#GStaticRWLock" title="GStaticRWLock"><span class="type">GStaticRWLock</span></a> to lock for reading.
2209
+ </td>
2210
+ </tr>
2211
+ <tr>
2212
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2213
+ <td>
2214
+ <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a>, if <em class="parameter"><code>lock</code></em> could be locked for reading.
2215
+ </td>
2216
+ </tr>
2217
+ </tbody>
2218
+ </table></div>
2219
+ </div>
2220
+ <hr>
2221
+ <div class="refsect2" title="g_static_rw_lock_reader_unlock ()">
2222
+ <a name="g-static-rw-lock-reader-unlock"></a><h3>g_static_rw_lock_reader_unlock ()</h3>
2223
+ <pre class="programlisting"><span class="returnvalue">void</span> g_static_rw_lock_reader_unlock (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticRWLock" title="GStaticRWLock"><span class="type">GStaticRWLock</span></a> *lock</code></em>);</pre>
2224
+ <p>
2225
+ Unlocks <em class="parameter"><code>lock</code></em>. If a thread waits to lock <em class="parameter"><code>lock</code></em> for writing and all
2226
+ locks for reading have been unlocked, the waiting thread is woken up
2227
+ and can lock <em class="parameter"><code>lock</code></em> for writing.
2228
+ </p>
2229
+ <div class="variablelist"><table border="0">
2230
+ <col align="left" valign="top">
2231
+ <tbody><tr>
2232
+ <td><p><span class="term"><em class="parameter"><code>lock</code></em> :</span></p></td>
2233
+ <td>a <a class="link" href="glib-Threads.html#GStaticRWLock" title="GStaticRWLock"><span class="type">GStaticRWLock</span></a> to unlock after reading.
2234
+ </td>
2235
+ </tr></tbody>
2236
+ </table></div>
2237
+ </div>
2238
+ <hr>
2239
+ <div class="refsect2" title="g_static_rw_lock_writer_lock ()">
2240
+ <a name="g-static-rw-lock-writer-lock"></a><h3>g_static_rw_lock_writer_lock ()</h3>
2241
+ <pre class="programlisting"><span class="returnvalue">void</span> g_static_rw_lock_writer_lock (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticRWLock" title="GStaticRWLock"><span class="type">GStaticRWLock</span></a> *lock</code></em>);</pre>
2242
+ <p>
2243
+ Locks <em class="parameter"><code>lock</code></em> for writing. If <em class="parameter"><code>lock</code></em> is already locked for writing or
2244
+ reading by other threads, this function will block until <em class="parameter"><code>lock</code></em> is
2245
+ completely unlocked and then lock <em class="parameter"><code>lock</code></em> for writing. While this
2246
+ functions waits to lock <em class="parameter"><code>lock</code></em>, no other thread can lock <em class="parameter"><code>lock</code></em> for
2247
+ reading. When <em class="parameter"><code>lock</code></em> is locked for writing, no other thread can lock
2248
+ <em class="parameter"><code>lock</code></em> (neither for reading nor writing). This lock has to be
2249
+ unlocked by <a class="link" href="glib-Threads.html#g-static-rw-lock-writer-unlock" title="g_static_rw_lock_writer_unlock ()"><code class="function">g_static_rw_lock_writer_unlock()</code></a>.
2250
+ </p>
2251
+ <div class="variablelist"><table border="0">
2252
+ <col align="left" valign="top">
2253
+ <tbody><tr>
2254
+ <td><p><span class="term"><em class="parameter"><code>lock</code></em> :</span></p></td>
2255
+ <td>a <a class="link" href="glib-Threads.html#GStaticRWLock" title="GStaticRWLock"><span class="type">GStaticRWLock</span></a> to lock for writing.
2256
+ </td>
2257
+ </tr></tbody>
2258
+ </table></div>
2259
+ </div>
2260
+ <hr>
2261
+ <div class="refsect2" title="g_static_rw_lock_writer_trylock ()">
2262
+ <a name="g-static-rw-lock-writer-trylock"></a><h3>g_static_rw_lock_writer_trylock ()</h3>
2263
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_static_rw_lock_writer_trylock (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticRWLock" title="GStaticRWLock"><span class="type">GStaticRWLock</span></a> *lock</code></em>);</pre>
2264
+ <p>
2265
+ Tries to lock <em class="parameter"><code>lock</code></em> for writing. If <em class="parameter"><code>lock</code></em> is already locked (for
2266
+ either reading or writing) by another thread, it immediately returns
2267
+ <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a>. Otherwise it locks <em class="parameter"><code>lock</code></em> for writing and returns <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a>. This
2268
+ lock has to be unlocked by <a class="link" href="glib-Threads.html#g-static-rw-lock-writer-unlock" title="g_static_rw_lock_writer_unlock ()"><code class="function">g_static_rw_lock_writer_unlock()</code></a>.
2269
+ </p>
2270
+ <div class="variablelist"><table border="0">
2271
+ <col align="left" valign="top">
2272
+ <tbody>
2273
+ <tr>
2274
+ <td><p><span class="term"><em class="parameter"><code>lock</code></em> :</span></p></td>
2275
+ <td>a <a class="link" href="glib-Threads.html#GStaticRWLock" title="GStaticRWLock"><span class="type">GStaticRWLock</span></a> to lock for writing.
2276
+ </td>
2277
+ </tr>
2278
+ <tr>
2279
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2280
+ <td>
2281
+ <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a>, if <em class="parameter"><code>lock</code></em> could be locked for writing.
2282
+ </td>
2283
+ </tr>
2284
+ </tbody>
2285
+ </table></div>
2286
+ </div>
2287
+ <hr>
2288
+ <div class="refsect2" title="g_static_rw_lock_writer_unlock ()">
2289
+ <a name="g-static-rw-lock-writer-unlock"></a><h3>g_static_rw_lock_writer_unlock ()</h3>
2290
+ <pre class="programlisting"><span class="returnvalue">void</span> g_static_rw_lock_writer_unlock (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticRWLock" title="GStaticRWLock"><span class="type">GStaticRWLock</span></a> *lock</code></em>);</pre>
2291
+ <p>
2292
+ Unlocks <em class="parameter"><code>lock</code></em>. If a thread is waiting to lock <em class="parameter"><code>lock</code></em> for writing and
2293
+ all locks for reading have been unlocked, the waiting thread is
2294
+ woken up and can lock <em class="parameter"><code>lock</code></em> for writing. If no thread is waiting to
2295
+ lock <em class="parameter"><code>lock</code></em> for writing, and some thread or threads are waiting to
2296
+ lock <em class="parameter"><code>lock</code></em> for reading, the waiting threads are woken up and can
2297
+ lock <em class="parameter"><code>lock</code></em> for reading.
2298
+ </p>
2299
+ <div class="variablelist"><table border="0">
2300
+ <col align="left" valign="top">
2301
+ <tbody><tr>
2302
+ <td><p><span class="term"><em class="parameter"><code>lock</code></em> :</span></p></td>
2303
+ <td>a <a class="link" href="glib-Threads.html#GStaticRWLock" title="GStaticRWLock"><span class="type">GStaticRWLock</span></a> to unlock after writing.
2304
+ </td>
2305
+ </tr></tbody>
2306
+ </table></div>
2307
+ </div>
2308
+ <hr>
2309
+ <div class="refsect2" title="g_static_rw_lock_free ()">
2310
+ <a name="g-static-rw-lock-free"></a><h3>g_static_rw_lock_free ()</h3>
2311
+ <pre class="programlisting"><span class="returnvalue">void</span> g_static_rw_lock_free (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticRWLock" title="GStaticRWLock"><span class="type">GStaticRWLock</span></a> *lock</code></em>);</pre>
2312
+ <p>
2313
+ Releases all resources allocated to <em class="parameter"><code>lock</code></em>.
2314
+ </p>
2315
+ <p>
2316
+ You don't have to call this functions for a <a class="link" href="glib-Threads.html#GStaticRWLock" title="GStaticRWLock"><span class="type">GStaticRWLock</span></a> with an
2317
+ unbounded lifetime, i.e. objects declared 'static', but if you have
2318
+ a <a class="link" href="glib-Threads.html#GStaticRWLock" title="GStaticRWLock"><span class="type">GStaticRWLock</span></a> as a member of a structure, and the structure is
2319
+ freed, you should also free the <a class="link" href="glib-Threads.html#GStaticRWLock" title="GStaticRWLock"><span class="type">GStaticRWLock</span></a>.
2320
+ </p>
2321
+ <div class="variablelist"><table border="0">
2322
+ <col align="left" valign="top">
2323
+ <tbody><tr>
2324
+ <td><p><span class="term"><em class="parameter"><code>lock</code></em> :</span></p></td>
2325
+ <td>a <a class="link" href="glib-Threads.html#GStaticRWLock" title="GStaticRWLock"><span class="type">GStaticRWLock</span></a> to be freed.
2326
+ </td>
2327
+ </tr></tbody>
2328
+ </table></div>
2329
+ </div>
2330
+ <hr>
2331
+ <div class="refsect2" title="GCond">
2332
+ <a name="GCond"></a><h3>GCond</h3>
2333
+ <pre class="programlisting">typedef struct _GCond GCond;</pre>
2334
+ <p>
2335
+ The <a class="link" href="glib-Threads.html#GCond" title="GCond"><span class="type">GCond</span></a> struct is an opaque data structure that represents a
2336
+ condition. Threads can block on a <a class="link" href="glib-Threads.html#GCond" title="GCond"><span class="type">GCond</span></a> if they find a certain
2337
+ condition to be false. If other threads change the state of this
2338
+ condition they signal the <a class="link" href="glib-Threads.html#GCond" title="GCond"><span class="type">GCond</span></a>, and that causes the waiting
2339
+ threads to be woken up.
2340
+ </p>
2341
+ <p>
2342
+ </p>
2343
+ <div class="example">
2344
+ <a name="id610685"></a><p class="title"><b>Example 8. 
2345
+ Using GCond to block a thread until a condition is satisfied
2346
+ </b></p>
2347
+ <div class="example-contents">
2348
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
2349
+ <tbody>
2350
+ <tr>
2351
+ <td class="listing_lines" align="right"><pre>1
2352
+ 2
2353
+ 3
2354
+ 4
2355
+ 5
2356
+ 6
2357
+ 7
2358
+ 8
2359
+ 9
2360
+ 10
2361
+ 11
2362
+ 12
2363
+ 13
2364
+ 14
2365
+ 15
2366
+ 16
2367
+ 17
2368
+ 18
2369
+ 19
2370
+ 20
2371
+ 21
2372
+ 22
2373
+ 23
2374
+ 24
2375
+ 25
2376
+ 26
2377
+ 27</pre></td>
2378
+ <td class="listing_code"><pre class="programlisting"><span class="normal"><a href="glib-Threads.html#GCond">GCond</a></span><span class="symbol">*</span><span class="normal"> data_cond </span><span class="symbol">=</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span><span class="normal"> </span><span class="comment">/* Must be initialized somewhere */</span>
2379
+ <span class="normal"><a href="glib-Threads.html#GMutex">GMutex</a></span><span class="symbol">*</span><span class="normal"> data_mutex </span><span class="symbol">=</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span><span class="normal"> </span><span class="comment">/* Must be initialized somewhere */</span>
2380
+ <span class="usertype">gpointer</span><span class="normal"> current_data </span><span class="symbol">=</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
2381
+
2382
+ <span class="type">void</span>
2383
+ <span class="function">push_data</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">gpointer</span><span class="normal"> data</span><span class="symbol">)</span>
2384
+ <span class="cbracket">{</span>
2385
+ <span class="normal"> </span><span class="function"><a href="glib-Threads.html#g-mutex-lock">g_mutex_lock</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">data_mutex</span><span class="symbol">);</span>
2386
+ <span class="normal"> current_data </span><span class="symbol">=</span><span class="normal"> data</span><span class="symbol">;</span>
2387
+ <span class="normal"> </span><span class="function"><a href="glib-Threads.html#g-cond-signal">g_cond_signal</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">data_cond</span><span class="symbol">);</span>
2388
+ <span class="normal"> </span><span class="function"><a href="glib-Threads.html#g-mutex-unlock">g_mutex_unlock</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">data_mutex</span><span class="symbol">);</span>
2389
+ <span class="cbracket">}</span>
2390
+
2391
+ <span class="normal"><a href="glib-Basic-Types.html#gpointer">gpointer</a></span>
2392
+ <span class="function">pop_data</span><span class="normal"> </span><span class="symbol">(</span><span class="type">void</span><span class="symbol">)</span>
2393
+ <span class="cbracket">{</span>
2394
+ <span class="normal"> </span><span class="usertype">gpointer</span><span class="normal"> data</span><span class="symbol">;</span>
2395
+
2396
+ <span class="normal"> </span><span class="function"><a href="glib-Threads.html#g-mutex-lock">g_mutex_lock</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">data_mutex</span><span class="symbol">);</span>
2397
+ <span class="normal"> </span><span class="keyword">while</span><span class="normal"> </span><span class="symbol">(!</span><span class="normal">current_data</span><span class="symbol">)</span>
2398
+ <span class="normal"> </span><span class="function"><a href="glib-Threads.html#g-cond-wait">g_cond_wait</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">data_cond</span><span class="symbol">,</span><span class="normal"> data_mutex</span><span class="symbol">);</span>
2399
+ <span class="normal"> data </span><span class="symbol">=</span><span class="normal"> current_data</span><span class="symbol">;</span>
2400
+ <span class="normal"> current_data </span><span class="symbol">=</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
2401
+ <span class="normal"> </span><span class="function"><a href="glib-Threads.html#g-mutex-unlock">g_mutex_unlock</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">data_mutex</span><span class="symbol">);</span>
2402
+
2403
+ <span class="normal"> </span><span class="keyword">return</span><span class="normal"> data</span><span class="symbol">;</span>
2404
+ <span class="cbracket">}</span></pre></td>
2405
+ </tr>
2406
+ </tbody>
2407
+ </table>
2408
+ </div>
2409
+
2410
+ </div>
2411
+ <p><br class="example-break">
2412
+ </p>
2413
+ <p>
2414
+ Whenever a thread calls <code class="function"><code class="function">pop_data()</code></code> now, it will
2415
+ wait until current_data is non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, i.e. until some other thread
2416
+ has called <code class="function"><code class="function">push_data()</code></code>.
2417
+ </p>
2418
+ <p>
2419
+ </p>
2420
+ <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
2421
+ <h3 class="title">Note</h3>
2422
+ <p>It is important to use the <a class="link" href="glib-Threads.html#g-cond-wait" title="g_cond_wait ()"><code class="function">g_cond_wait()</code></a> and
2423
+ <a class="link" href="glib-Threads.html#g-cond-timed-wait" title="g_cond_timed_wait ()"><code class="function">g_cond_timed_wait()</code></a> functions only inside a loop which checks for the
2424
+ condition to be true. It is not guaranteed that the waiting thread
2425
+ will find the condition fulfilled after it wakes up, even if the
2426
+ signaling thread left the condition in that state: another thread may
2427
+ have altered the condition before the waiting thread got the chance
2428
+ to be woken up, even if the condition itself is protected by a
2429
+ <a class="link" href="glib-Threads.html#GMutex" title="GMutex"><span class="type">GMutex</span></a>, like above.</p>
2430
+ </div>
2431
+ <p>
2432
+ </p>
2433
+ <p>
2434
+ A <a class="link" href="glib-Threads.html#GCond" title="GCond"><span class="type">GCond</span></a> should only be accessed via the following functions.
2435
+ </p>
2436
+ <p>
2437
+ </p>
2438
+ <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
2439
+ <h3 class="title">Note</h3>
2440
+ <p>All of the <code class="function">g_cond_*</code> functions are
2441
+ actually macros. Apart from taking their addresses, you can however
2442
+ use them as if they were functions.</p>
2443
+ </div>
2444
+ <p>
2445
+ </p>
2446
+ </div>
2447
+ <hr>
2448
+ <div class="refsect2" title="g_cond_new ()">
2449
+ <a name="g-cond-new"></a><h3>g_cond_new ()</h3>
2450
+ <pre class="programlisting"><a class="link" href="glib-Threads.html#GCond" title="GCond"><span class="returnvalue">GCond</span></a>* g_cond_new ();</pre>
2451
+ <p>
2452
+ Creates a new <a class="link" href="glib-Threads.html#GCond" title="GCond"><span class="type">GCond</span></a>. This function will abort, if <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a>
2453
+ has not been called yet.
2454
+ </p>
2455
+ <div class="variablelist"><table border="0">
2456
+ <col align="left" valign="top">
2457
+ <tbody><tr>
2458
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2459
+ <td>a new <a class="link" href="glib-Threads.html#GCond" title="GCond"><span class="type">GCond</span></a>.
2460
+ </td>
2461
+ </tr></tbody>
2462
+ </table></div>
2463
+ </div>
2464
+ <hr>
2465
+ <div class="refsect2" title="g_cond_signal ()">
2466
+ <a name="g-cond-signal"></a><h3>g_cond_signal ()</h3>
2467
+ <pre class="programlisting"><span class="returnvalue">void</span> g_cond_signal (<em class="parameter"><code><a class="link" href="glib-Threads.html#GCond" title="GCond"><span class="type">GCond</span></a> *cond</code></em>);</pre>
2468
+ <p>
2469
+ If threads are waiting for <em class="parameter"><code>cond</code></em>, exactly one of them is woken up.
2470
+ It is good practice to hold the same lock as the waiting thread
2471
+ while calling this function, though not required.
2472
+ </p>
2473
+ <p>
2474
+ This function can be used even if <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a> has not yet been
2475
+ called, and, in that case, will do nothing.
2476
+ </p>
2477
+ <div class="variablelist"><table border="0">
2478
+ <col align="left" valign="top">
2479
+ <tbody><tr>
2480
+ <td><p><span class="term"><em class="parameter"><code>cond</code></em> :</span></p></td>
2481
+ <td>a <a class="link" href="glib-Threads.html#GCond" title="GCond"><span class="type">GCond</span></a>.
2482
+ </td>
2483
+ </tr></tbody>
2484
+ </table></div>
2485
+ </div>
2486
+ <hr>
2487
+ <div class="refsect2" title="g_cond_broadcast ()">
2488
+ <a name="g-cond-broadcast"></a><h3>g_cond_broadcast ()</h3>
2489
+ <pre class="programlisting"><span class="returnvalue">void</span> g_cond_broadcast (<em class="parameter"><code><a class="link" href="glib-Threads.html#GCond" title="GCond"><span class="type">GCond</span></a> *cond</code></em>);</pre>
2490
+ <p>
2491
+ If threads are waiting for <em class="parameter"><code>cond</code></em>, all of them are woken up. It is
2492
+ good practice to lock the same mutex as the waiting threads, while
2493
+ calling this function, though not required.
2494
+ </p>
2495
+ <p>
2496
+ This function can be used even if <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a> has not yet been
2497
+ called, and, in that case, will do nothing.
2498
+ </p>
2499
+ <div class="variablelist"><table border="0">
2500
+ <col align="left" valign="top">
2501
+ <tbody><tr>
2502
+ <td><p><span class="term"><em class="parameter"><code>cond</code></em> :</span></p></td>
2503
+ <td>a <a class="link" href="glib-Threads.html#GCond" title="GCond"><span class="type">GCond</span></a>.
2504
+ </td>
2505
+ </tr></tbody>
2506
+ </table></div>
2507
+ </div>
2508
+ <hr>
2509
+ <div class="refsect2" title="g_cond_wait ()">
2510
+ <a name="g-cond-wait"></a><h3>g_cond_wait ()</h3>
2511
+ <pre class="programlisting"><span class="returnvalue">void</span> g_cond_wait (<em class="parameter"><code><a class="link" href="glib-Threads.html#GCond" title="GCond"><span class="type">GCond</span></a> *cond</code></em>,
2512
+ <em class="parameter"><code><a class="link" href="glib-Threads.html#GMutex" title="GMutex"><span class="type">GMutex</span></a> *mutex</code></em>);</pre>
2513
+ <p>
2514
+ Waits until this thread is woken up on <em class="parameter"><code>cond</code></em>. The <em class="parameter"><code>mutex</code></em> is unlocked
2515
+ before falling asleep and locked again before resuming.
2516
+ </p>
2517
+ <p>
2518
+ This function can be used even if <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a> has not yet been
2519
+ called, and, in that case, will immediately return.
2520
+ </p>
2521
+ <div class="variablelist"><table border="0">
2522
+ <col align="left" valign="top">
2523
+ <tbody>
2524
+ <tr>
2525
+ <td><p><span class="term"><em class="parameter"><code>cond</code></em> :</span></p></td>
2526
+ <td>a <a class="link" href="glib-Threads.html#GCond" title="GCond"><span class="type">GCond</span></a>.
2527
+ </td>
2528
+ </tr>
2529
+ <tr>
2530
+ <td><p><span class="term"><em class="parameter"><code>mutex</code></em> :</span></p></td>
2531
+ <td>a <a class="link" href="glib-Threads.html#GMutex" title="GMutex"><span class="type">GMutex</span></a>, that is currently locked.
2532
+ </td>
2533
+ </tr>
2534
+ </tbody>
2535
+ </table></div>
2536
+ </div>
2537
+ <hr>
2538
+ <div class="refsect2" title="g_cond_timed_wait ()">
2539
+ <a name="g-cond-timed-wait"></a><h3>g_cond_timed_wait ()</h3>
2540
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_cond_timed_wait (<em class="parameter"><code><a class="link" href="glib-Threads.html#GCond" title="GCond"><span class="type">GCond</span></a> *cond</code></em>,
2541
+ <em class="parameter"><code><a class="link" href="glib-Threads.html#GMutex" title="GMutex"><span class="type">GMutex</span></a> *mutex</code></em>,
2542
+ <em class="parameter"><code><a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal"><span class="type">GTimeVal</span></a> *abs_time</code></em>);</pre>
2543
+ <p>
2544
+ Waits until this thread is woken up on <em class="parameter"><code>cond</code></em>, but not longer than
2545
+ until the time specified by <em class="parameter"><code>abs_time</code></em>. The <em class="parameter"><code>mutex</code></em> is unlocked before
2546
+ falling asleep and locked again before resuming.
2547
+ </p>
2548
+ <p>
2549
+ If <em class="parameter"><code>abs_time</code></em> is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, <a class="link" href="glib-Threads.html#g-cond-timed-wait" title="g_cond_timed_wait ()"><code class="function">g_cond_timed_wait()</code></a> acts like <a class="link" href="glib-Threads.html#g-cond-wait" title="g_cond_wait ()"><code class="function">g_cond_wait()</code></a>.
2550
+ </p>
2551
+ <p>
2552
+ This function can be used even if <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a> has not yet been
2553
+ called, and, in that case, will immediately return <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a>.
2554
+ </p>
2555
+ <p>
2556
+ To easily calculate <em class="parameter"><code>abs_time</code></em> a combination of <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>
2557
+ and <a class="link" href="glib-Date-and-Time-Functions.html#g-time-val-add" title="g_time_val_add ()"><code class="function">g_time_val_add()</code></a> can be used.
2558
+ </p>
2559
+ <div class="variablelist"><table border="0">
2560
+ <col align="left" valign="top">
2561
+ <tbody>
2562
+ <tr>
2563
+ <td><p><span class="term"><em class="parameter"><code>cond</code></em> :</span></p></td>
2564
+ <td>a <a class="link" href="glib-Threads.html#GCond" title="GCond"><span class="type">GCond</span></a>.
2565
+ </td>
2566
+ </tr>
2567
+ <tr>
2568
+ <td><p><span class="term"><em class="parameter"><code>mutex</code></em> :</span></p></td>
2569
+ <td>a <a class="link" href="glib-Threads.html#GMutex" title="GMutex"><span class="type">GMutex</span></a> that is currently locked.
2570
+ </td>
2571
+ </tr>
2572
+ <tr>
2573
+ <td><p><span class="term"><em class="parameter"><code>abs_time</code></em> :</span></p></td>
2574
+ <td>a <a class="link" href="glib-Date-and-Time-Functions.html#GTimeVal" title="GTimeVal"><span class="type">GTimeVal</span></a>, determining the final time.
2575
+ </td>
2576
+ </tr>
2577
+ <tr>
2578
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2579
+ <td>
2580
+ <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if <em class="parameter"><code>cond</code></em> was signalled, or <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> on timeout.
2581
+ </td>
2582
+ </tr>
2583
+ </tbody>
2584
+ </table></div>
2585
+ </div>
2586
+ <hr>
2587
+ <div class="refsect2" title="g_cond_free ()">
2588
+ <a name="g-cond-free"></a><h3>g_cond_free ()</h3>
2589
+ <pre class="programlisting"><span class="returnvalue">void</span> g_cond_free (<em class="parameter"><code><a class="link" href="glib-Threads.html#GCond" title="GCond"><span class="type">GCond</span></a> *cond</code></em>);</pre>
2590
+ <p>
2591
+ Destroys the <a class="link" href="glib-Threads.html#GCond" title="GCond"><span class="type">GCond</span></a>.
2592
+ </p>
2593
+ <div class="variablelist"><table border="0">
2594
+ <col align="left" valign="top">
2595
+ <tbody><tr>
2596
+ <td><p><span class="term"><em class="parameter"><code>cond</code></em> :</span></p></td>
2597
+ <td>a <a class="link" href="glib-Threads.html#GCond" title="GCond"><span class="type">GCond</span></a>.
2598
+ </td>
2599
+ </tr></tbody>
2600
+ </table></div>
2601
+ </div>
2602
+ <hr>
2603
+ <div class="refsect2" title="GPrivate">
2604
+ <a name="GPrivate"></a><h3>GPrivate</h3>
2605
+ <pre class="programlisting">typedef struct _GPrivate GPrivate;</pre>
2606
+ <p>
2607
+ The <a class="link" href="glib-Threads.html#GPrivate" title="GPrivate"><span class="type">GPrivate</span></a> struct is an opaque data structure to represent a
2608
+ thread private data key. Threads can thereby obtain and set a
2609
+ pointer which is private to the current thread. Take our
2610
+ <code class="function">give_me_next_number()</code> example from
2611
+ above. Suppose we don't want <code class="literal">current_number</code> to be
2612
+ shared between the threads, but instead to be private to each thread.
2613
+ This can be done as follows:
2614
+ </p>
2615
+ <p>
2616
+ </p>
2617
+ <div class="example">
2618
+ <a name="id611735"></a><p class="title"><b>Example 9. Using GPrivate for per-thread data</b></p>
2619
+ <div class="example-contents">
2620
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
2621
+ <tbody>
2622
+ <tr>
2623
+ <td class="listing_lines" align="right"><pre>1
2624
+ 2
2625
+ 3
2626
+ 4
2627
+ 5
2628
+ 6
2629
+ 7
2630
+ 8
2631
+ 9
2632
+ 10
2633
+ 11
2634
+ 12
2635
+ 13
2636
+ 14
2637
+ 15
2638
+ 16
2639
+ 17
2640
+ 18
2641
+ 19</pre></td>
2642
+ <td class="listing_code"><pre class="programlisting"><span class="normal"><a href="glib-Threads.html#GPrivate">GPrivate</a></span><span class="symbol">*</span><span class="normal"> current_number_key </span><span class="symbol">=</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span><span class="normal"> </span><span class="comment">/* Must be initialized somewhere</span>
2643
+ <span class="comment"> with g_private_new (g_free); */</span>
2644
+
2645
+ <span class="type">int</span>
2646
+ <span class="function">give_me_next_number</span><span class="normal"> </span><span class="symbol">(</span><span class="type">void</span><span class="symbol">)</span>
2647
+ <span class="cbracket">{</span>
2648
+ <span class="normal"> </span><span class="type">int</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">current_number </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-Threads.html#g-private-get">g_private_get</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">current_number_key</span><span class="symbol">);</span>
2649
+
2650
+ <span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(!</span><span class="normal">current_number</span><span class="symbol">)</span>
2651
+ <span class="normal"> </span><span class="cbracket">{</span>
2652
+ <span class="normal"> current_number </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-Memory-Allocation.html#g-new">g_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="type">int</span><span class="symbol">,</span><span class="normal"> </span><span class="number">1</span><span class="symbol">);</span>
2653
+ <span class="normal"> </span><span class="symbol">*</span><span class="normal">current_number </span><span class="symbol">=</span><span class="normal"> </span><span class="number">0</span><span class="symbol">;</span>
2654
+ <span class="normal"> </span><span class="function"><a href="glib-Threads.html#g-private-set">g_private_set</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">current_number_key</span><span class="symbol">,</span><span class="normal"> current_number</span><span class="symbol">);</span>
2655
+ <span class="normal"> </span><span class="cbracket">}</span>
2656
+
2657
+ <span class="normal"> </span><span class="symbol">*</span><span class="normal">current_number </span><span class="symbol">=</span><span class="normal"> </span><span class="function">calc_next_number</span><span class="normal"> </span><span class="symbol">(*</span><span class="normal">current_number</span><span class="symbol">);</span>
2658
+
2659
+ <span class="normal"> </span><span class="keyword">return</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">current_number</span><span class="symbol">;</span>
2660
+ <span class="cbracket">}</span></pre></td>
2661
+ </tr>
2662
+ </tbody>
2663
+ </table>
2664
+ </div>
2665
+
2666
+ </div>
2667
+ <p><br class="example-break">
2668
+ </p>
2669
+ <p>
2670
+ Here the pointer belonging to the key
2671
+ <code class="literal">current_number_key</code> is read. If it is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, it has
2672
+ not been set yet. Then get memory for an integer value, assign this
2673
+ memory to the pointer and write the pointer back. Now we have an
2674
+ integer value that is private to the current thread.
2675
+ </p>
2676
+ <p>
2677
+ The <a class="link" href="glib-Threads.html#GPrivate" title="GPrivate"><span class="type">GPrivate</span></a> struct should only be accessed via the following
2678
+ functions.
2679
+ </p>
2680
+ <p>
2681
+ </p>
2682
+ <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
2683
+ <h3 class="title">Note</h3>
2684
+ <p>All of the <code class="function">g_private_*</code> functions are
2685
+ actually macros. Apart from taking their addresses, you can however
2686
+ use them as if they were functions.</p>
2687
+ </div>
2688
+ <p>
2689
+ </p>
2690
+ </div>
2691
+ <hr>
2692
+ <div class="refsect2" title="g_private_new ()">
2693
+ <a name="g-private-new"></a><h3>g_private_new ()</h3>
2694
+ <pre class="programlisting"><a class="link" href="glib-Threads.html#GPrivate" title="GPrivate"><span class="returnvalue">GPrivate</span></a>* g_private_new (<em class="parameter"><code><a class="link" href="glib-Datasets.html#GDestroyNotify" title="GDestroyNotify ()"><span class="type">GDestroyNotify</span></a> destructor</code></em>);</pre>
2695
+ <p>
2696
+ Creates a new <a class="link" href="glib-Threads.html#GPrivate" title="GPrivate"><span class="type">GPrivate</span></a>. If <em class="parameter"><code>destructor</code></em> is non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, it is a
2697
+ pointer to a destructor function. Whenever a thread ends and the
2698
+ corresponding pointer keyed to this instance of <a class="link" href="glib-Threads.html#GPrivate" title="GPrivate"><span class="type">GPrivate</span></a> is
2699
+ non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, the destructor is called with this pointer as the
2700
+ argument.
2701
+ </p>
2702
+ <p>
2703
+ </p>
2704
+ <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
2705
+ <h3 class="title">Note</h3>
2706
+ <p><em class="parameter"><code>destructor</code></em> is used quite differently from <em class="parameter"><code>notify</code></em> in
2707
+ <a class="link" href="glib-Threads.html#g-static-private-set" title="g_static_private_set ()"><code class="function">g_static_private_set()</code></a>.</p>
2708
+ </div>
2709
+ <p>
2710
+ </p>
2711
+ <p>
2712
+ </p>
2713
+ <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
2714
+ <h3 class="title">Note</h3>
2715
+ <p>A <a class="link" href="glib-Threads.html#GPrivate" title="GPrivate"><span class="type">GPrivate</span></a> can not be freed. Reuse it instead, if you
2716
+ can, to avoid shortage, or use <a class="link" href="glib-Threads.html#GStaticPrivate" title="GStaticPrivate"><span class="type">GStaticPrivate</span></a>.</p>
2717
+ </div>
2718
+ <p>
2719
+ </p>
2720
+ <p>
2721
+ </p>
2722
+ <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
2723
+ <h3 class="title">Note</h3>
2724
+ <p>This function will abort if <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a> has not been
2725
+ called yet.</p>
2726
+ </div>
2727
+ <p>
2728
+ </p>
2729
+ <div class="variablelist"><table border="0">
2730
+ <col align="left" valign="top">
2731
+ <tbody>
2732
+ <tr>
2733
+ <td><p><span class="term"><em class="parameter"><code>destructor</code></em> :</span></p></td>
2734
+ <td>a function to destroy the data keyed to <a class="link" href="glib-Threads.html#GPrivate" title="GPrivate"><span class="type">GPrivate</span></a> when
2735
+ a thread ends.
2736
+ </td>
2737
+ </tr>
2738
+ <tr>
2739
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2740
+ <td>a new <a class="link" href="glib-Threads.html#GPrivate" title="GPrivate"><span class="type">GPrivate</span></a>.
2741
+ </td>
2742
+ </tr>
2743
+ </tbody>
2744
+ </table></div>
2745
+ </div>
2746
+ <hr>
2747
+ <div class="refsect2" title="g_private_get ()">
2748
+ <a name="g-private-get"></a><h3>g_private_get ()</h3>
2749
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a> g_private_get (<em class="parameter"><code><a class="link" href="glib-Threads.html#GPrivate" title="GPrivate"><span class="type">GPrivate</span></a> *private_key</code></em>);</pre>
2750
+ <p>
2751
+ Returns the pointer keyed to <em class="parameter"><code>private_key</code></em> for the current thread. If
2752
+ <a class="link" href="glib-Threads.html#g-private-set" title="g_private_set ()"><code class="function">g_private_set()</code></a> hasn't been called for the current <em class="parameter"><code>private_key</code></em> and
2753
+ thread yet, this pointer will be <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
2754
+ </p>
2755
+ <p>
2756
+ This function can be used even if <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a> has not yet been
2757
+ called, and, in that case, will return the value of <em class="parameter"><code>private_key</code></em>
2758
+ casted to <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a>. Note however, that private data set
2759
+ <span class="emphasis"><em>before</em></span> <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a> will
2760
+ <span class="emphasis"><em>not</em></span> be retained <span class="emphasis"><em>after</em></span> the
2761
+ call. Instead, <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> will be returned in all threads directly after
2762
+ <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a>, regardless of any <a class="link" href="glib-Threads.html#g-private-set" title="g_private_set ()"><code class="function">g_private_set()</code></a> calls issued
2763
+ before threading system intialization.
2764
+ </p>
2765
+ <div class="variablelist"><table border="0">
2766
+ <col align="left" valign="top">
2767
+ <tbody>
2768
+ <tr>
2769
+ <td><p><span class="term"><em class="parameter"><code>private_key</code></em> :</span></p></td>
2770
+ <td>a <a class="link" href="glib-Threads.html#GPrivate" title="GPrivate"><span class="type">GPrivate</span></a>.
2771
+ </td>
2772
+ </tr>
2773
+ <tr>
2774
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2775
+ <td>the corresponding pointer.
2776
+ </td>
2777
+ </tr>
2778
+ </tbody>
2779
+ </table></div>
2780
+ </div>
2781
+ <hr>
2782
+ <div class="refsect2" title="g_private_set ()">
2783
+ <a name="g-private-set"></a><h3>g_private_set ()</h3>
2784
+ <pre class="programlisting"><span class="returnvalue">void</span> g_private_set (<em class="parameter"><code><a class="link" href="glib-Threads.html#GPrivate" title="GPrivate"><span class="type">GPrivate</span></a> *private_key</code></em>,
2785
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
2786
+ <p>
2787
+ Sets the pointer keyed to <em class="parameter"><code>private_key</code></em> for the current thread.
2788
+ </p>
2789
+ <p>
2790
+ This function can be used even if <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a> has not yet been
2791
+ called, and, in that case, will set <em class="parameter"><code>private_key</code></em> to <em class="parameter"><code>data</code></em> casted to
2792
+ <a class="link" href="glib-Threads.html#GPrivate" title="GPrivate"><span class="type">GPrivate</span></a>*. See <a class="link" href="glib-Threads.html#g-private-get" title="g_private_get ()"><code class="function">g_private_get()</code></a> for resulting caveats.
2793
+ </p>
2794
+ <div class="variablelist"><table border="0">
2795
+ <col align="left" valign="top">
2796
+ <tbody>
2797
+ <tr>
2798
+ <td><p><span class="term"><em class="parameter"><code>private_key</code></em> :</span></p></td>
2799
+ <td>a <a class="link" href="glib-Threads.html#GPrivate" title="GPrivate"><span class="type">GPrivate</span></a>.
2800
+ </td>
2801
+ </tr>
2802
+ <tr>
2803
+ <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
2804
+ <td>the new pointer.
2805
+ </td>
2806
+ </tr>
2807
+ </tbody>
2808
+ </table></div>
2809
+ </div>
2810
+ <hr>
2811
+ <div class="refsect2" title="GStaticPrivate">
2812
+ <a name="GStaticPrivate"></a><h3>GStaticPrivate</h3>
2813
+ <pre class="programlisting">typedef struct {
2814
+ } GStaticPrivate;
2815
+ </pre>
2816
+ <p>
2817
+ A <a class="link" href="glib-Threads.html#GStaticPrivate" title="GStaticPrivate"><span class="type">GStaticPrivate</span></a> works almost like a <a class="link" href="glib-Threads.html#GPrivate" title="GPrivate"><span class="type">GPrivate</span></a>, but it has one
2818
+ significant advantage. It doesn't need to be created at run-time
2819
+ like a <a class="link" href="glib-Threads.html#GPrivate" title="GPrivate"><span class="type">GPrivate</span></a>, but can be defined at compile-time. This is
2820
+ similar to the difference between <a class="link" href="glib-Threads.html#GMutex" title="GMutex"><span class="type">GMutex</span></a> and <a class="link" href="glib-Threads.html#GStaticMutex" title="GStaticMutex"><span class="type">GStaticMutex</span></a>. Now
2821
+ look at our <code class="function"><code class="function">give_me_next_number()</code></code> example with
2822
+ <a class="link" href="glib-Threads.html#GStaticPrivate" title="GStaticPrivate"><span class="type">GStaticPrivate</span></a>:
2823
+ </p>
2824
+ <p>
2825
+ </p>
2826
+ <div class="example">
2827
+ <a name="id612504"></a><p class="title"><b>Example 10. Using GStaticPrivate for per-thread data</b></p>
2828
+ <div class="example-contents">
2829
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
2830
+ <tbody>
2831
+ <tr>
2832
+ <td class="listing_lines" align="right"><pre>1
2833
+ 2
2834
+ 3
2835
+ 4
2836
+ 5
2837
+ 6
2838
+ 7
2839
+ 8
2840
+ 9
2841
+ 10
2842
+ 11
2843
+ 12
2844
+ 13
2845
+ 14
2846
+ 15
2847
+ 16
2848
+ 17</pre></td>
2849
+ <td class="listing_code"><pre class="programlisting"><span class="type">int</span>
2850
+ <span class="function">give_me_next_number</span><span class="normal"> </span><span class="symbol">()</span>
2851
+ <span class="cbracket">{</span>
2852
+ <span class="normal"> </span><span class="keyword">static</span><span class="normal"> </span><span class="usertype">GStaticPrivate</span><span class="normal"> current_number_key </span><span class="symbol">=</span><span class="normal"> <a href="glib-Threads.html#G-STATIC-PRIVATE-INIT:CAPS">G_STATIC_PRIVATE_INIT</a></span><span class="symbol">;</span>
2853
+ <span class="normal"> </span><span class="type">int</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">current_number </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-Threads.html#g-static-private-get">g_static_private_get</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">current_number_key</span><span class="symbol">);</span>
2854
+
2855
+ <span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(!</span><span class="normal">current_number</span><span class="symbol">)</span>
2856
+ <span class="normal"> </span><span class="cbracket">{</span>
2857
+ <span class="normal"> current_number </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-Memory-Allocation.html#g-new">g_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="type">int</span><span class="symbol">,</span><span class="number">1</span><span class="symbol">);</span>
2858
+ <span class="normal"> </span><span class="symbol">*</span><span class="normal">current_number </span><span class="symbol">=</span><span class="normal"> </span><span class="number">0</span><span class="symbol">;</span>
2859
+ <span class="normal"> </span><span class="function"><a href="glib-Threads.html#g-static-private-set">g_static_private_set</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">current_number_key</span><span class="symbol">,</span><span class="normal"> current_number</span><span class="symbol">,</span><span class="normal"> <a href="glib-Memory-Allocation.html#g-free">g_free</a></span><span class="symbol">);</span>
2860
+ <span class="normal"> </span><span class="cbracket">}</span>
2861
+
2862
+ <span class="normal"> </span><span class="symbol">*</span><span class="normal">current_number </span><span class="symbol">=</span><span class="normal"> </span><span class="function">calc_next_number</span><span class="normal"> </span><span class="symbol">(*</span><span class="normal">current_number</span><span class="symbol">);</span>
2863
+
2864
+ <span class="normal"> </span><span class="keyword">return</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">current_number</span><span class="symbol">;</span>
2865
+ <span class="cbracket">}</span></pre></td>
2866
+ </tr>
2867
+ </tbody>
2868
+ </table>
2869
+ </div>
2870
+
2871
+ </div>
2872
+ <p><br class="example-break">
2873
+ </p>
2874
+ </div>
2875
+ <hr>
2876
+ <div class="refsect2" title="G_STATIC_PRIVATE_INIT">
2877
+ <a name="G-STATIC-PRIVATE-INIT:CAPS"></a><h3>G_STATIC_PRIVATE_INIT</h3>
2878
+ <pre class="programlisting">#define G_STATIC_PRIVATE_INIT
2879
+ </pre>
2880
+ <p>
2881
+ Every <a class="link" href="glib-Threads.html#GStaticPrivate" title="GStaticPrivate"><span class="type">GStaticPrivate</span></a> must be initialized with this macro, before it
2882
+ can be used.
2883
+ </p>
2884
+ <p>
2885
+ </p>
2886
+ <div class="informalexample">
2887
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
2888
+ <tbody>
2889
+ <tr>
2890
+ <td class="listing_lines" align="right"><pre>1</pre></td>
2891
+ <td class="listing_code"><pre class="programlisting"><span class="usertype">GStaticPrivate</span><span class="normal"> my_private </span><span class="symbol">=</span><span class="normal"> <a href="glib-Threads.html#G-STATIC-PRIVATE-INIT:CAPS">G_STATIC_PRIVATE_INIT</a></span><span class="symbol">;</span></pre></td>
2892
+ </tr>
2893
+ </tbody>
2894
+ </table>
2895
+ </div>
2896
+
2897
+ <p>
2898
+ </p>
2899
+ </div>
2900
+ <hr>
2901
+ <div class="refsect2" title="g_static_private_init ()">
2902
+ <a name="g-static-private-init"></a><h3>g_static_private_init ()</h3>
2903
+ <pre class="programlisting"><span class="returnvalue">void</span> g_static_private_init (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticPrivate" title="GStaticPrivate"><span class="type">GStaticPrivate</span></a> *private_key</code></em>);</pre>
2904
+ <p>
2905
+ Initializes <em class="parameter"><code>private_key</code></em>. Alternatively you can initialize it with
2906
+ <a class="link" href="glib-Threads.html#G-STATIC-PRIVATE-INIT:CAPS" title="G_STATIC_PRIVATE_INIT"><span class="type">G_STATIC_PRIVATE_INIT</span></a>.
2907
+ </p>
2908
+ <div class="variablelist"><table border="0">
2909
+ <col align="left" valign="top">
2910
+ <tbody><tr>
2911
+ <td><p><span class="term"><em class="parameter"><code>private_key</code></em> :</span></p></td>
2912
+ <td>a <a class="link" href="glib-Threads.html#GStaticPrivate" title="GStaticPrivate"><span class="type">GStaticPrivate</span></a> to be initialized.
2913
+ </td>
2914
+ </tr></tbody>
2915
+ </table></div>
2916
+ </div>
2917
+ <hr>
2918
+ <div class="refsect2" title="g_static_private_get ()">
2919
+ <a name="g-static-private-get"></a><h3>g_static_private_get ()</h3>
2920
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a> g_static_private_get (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticPrivate" title="GStaticPrivate"><span class="type">GStaticPrivate</span></a> *private_key</code></em>);</pre>
2921
+ <p>
2922
+ Works like <a class="link" href="glib-Threads.html#g-private-get" title="g_private_get ()"><code class="function">g_private_get()</code></a> only for a <a class="link" href="glib-Threads.html#GStaticPrivate" title="GStaticPrivate"><span class="type">GStaticPrivate</span></a>.
2923
+ </p>
2924
+ <p>
2925
+ This function works even if <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a> has not yet been called.
2926
+ </p>
2927
+ <div class="variablelist"><table border="0">
2928
+ <col align="left" valign="top">
2929
+ <tbody>
2930
+ <tr>
2931
+ <td><p><span class="term"><em class="parameter"><code>private_key</code></em> :</span></p></td>
2932
+ <td>a <a class="link" href="glib-Threads.html#GStaticPrivate" title="GStaticPrivate"><span class="type">GStaticPrivate</span></a>.
2933
+ </td>
2934
+ </tr>
2935
+ <tr>
2936
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2937
+ <td>the corresponding pointer.
2938
+ </td>
2939
+ </tr>
2940
+ </tbody>
2941
+ </table></div>
2942
+ </div>
2943
+ <hr>
2944
+ <div class="refsect2" title="g_static_private_set ()">
2945
+ <a name="g-static-private-set"></a><h3>g_static_private_set ()</h3>
2946
+ <pre class="programlisting"><span class="returnvalue">void</span> g_static_private_set (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticPrivate" title="GStaticPrivate"><span class="type">GStaticPrivate</span></a> *private_key</code></em>,
2947
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> data</code></em>,
2948
+ <em class="parameter"><code><a class="link" href="glib-Datasets.html#GDestroyNotify" title="GDestroyNotify ()"><span class="type">GDestroyNotify</span></a> notify</code></em>);</pre>
2949
+ <p>
2950
+ Sets the pointer keyed to <em class="parameter"><code>private_key</code></em> for the current thread and
2951
+ the function <em class="parameter"><code>notify</code></em> to be called with that pointer (<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> or
2952
+ non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>), whenever the pointer is set again or whenever the
2953
+ current thread ends.
2954
+ </p>
2955
+ <p>
2956
+ This function works even if <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a> has not yet been called.
2957
+ If <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a> is called later, the <em class="parameter"><code>data</code></em> keyed to <em class="parameter"><code>private_key</code></em>
2958
+ will be inherited only by the main thread, i.e. the one that called
2959
+ <a class="link" href="glib-Threads.html#g-thread-init" title="g_thread_init ()"><code class="function">g_thread_init()</code></a>.
2960
+ </p>
2961
+ <p>
2962
+ </p>
2963
+ <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
2964
+ <h3 class="title">Note</h3>
2965
+ <p><em class="parameter"><code>notify</code></em> is used quite differently from <em class="parameter"><code>destructor</code></em> in
2966
+ <a class="link" href="glib-Threads.html#g-private-new" title="g_private_new ()"><code class="function">g_private_new()</code></a>.</p>
2967
+ </div>
2968
+ <p>
2969
+ </p>
2970
+ <div class="variablelist"><table border="0">
2971
+ <col align="left" valign="top">
2972
+ <tbody>
2973
+ <tr>
2974
+ <td><p><span class="term"><em class="parameter"><code>private_key</code></em> :</span></p></td>
2975
+ <td>a <a class="link" href="glib-Threads.html#GStaticPrivate" title="GStaticPrivate"><span class="type">GStaticPrivate</span></a>.
2976
+ </td>
2977
+ </tr>
2978
+ <tr>
2979
+ <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
2980
+ <td>the new pointer.
2981
+ </td>
2982
+ </tr>
2983
+ <tr>
2984
+ <td><p><span class="term"><em class="parameter"><code>notify</code></em> :</span></p></td>
2985
+ <td>a function to be called with the pointer whenever the
2986
+ current thread ends or sets this pointer again.
2987
+ </td>
2988
+ </tr>
2989
+ </tbody>
2990
+ </table></div>
2991
+ </div>
2992
+ <hr>
2993
+ <div class="refsect2" title="g_static_private_free ()">
2994
+ <a name="g-static-private-free"></a><h3>g_static_private_free ()</h3>
2995
+ <pre class="programlisting"><span class="returnvalue">void</span> g_static_private_free (<em class="parameter"><code><a class="link" href="glib-Threads.html#GStaticPrivate" title="GStaticPrivate"><span class="type">GStaticPrivate</span></a> *private_key</code></em>);</pre>
2996
+ <p>
2997
+ Releases all resources allocated to <em class="parameter"><code>private_key</code></em>.
2998
+ </p>
2999
+ <p>
3000
+ You don't have to call this functions for a <a class="link" href="glib-Threads.html#GStaticPrivate" title="GStaticPrivate"><span class="type">GStaticPrivate</span></a> with an
3001
+ unbounded lifetime, i.e. objects declared 'static', but if you have
3002
+ a <a class="link" href="glib-Threads.html#GStaticPrivate" title="GStaticPrivate"><span class="type">GStaticPrivate</span></a> as a member of a structure and the structure is
3003
+ freed, you should also free the <a class="link" href="glib-Threads.html#GStaticPrivate" title="GStaticPrivate"><span class="type">GStaticPrivate</span></a>.
3004
+ </p>
3005
+ <div class="variablelist"><table border="0">
3006
+ <col align="left" valign="top">
3007
+ <tbody><tr>
3008
+ <td><p><span class="term"><em class="parameter"><code>private_key</code></em> :</span></p></td>
3009
+ <td>a <a class="link" href="glib-Threads.html#GStaticPrivate" title="GStaticPrivate"><span class="type">GStaticPrivate</span></a> to be freed.
3010
+ </td>
3011
+ </tr></tbody>
3012
+ </table></div>
3013
+ </div>
3014
+ <hr>
3015
+ <div class="refsect2" title="GOnce">
3016
+ <a name="GOnce"></a><h3>GOnce</h3>
3017
+ <pre class="programlisting">typedef struct {
3018
+ volatile GOnceStatus status;
3019
+ volatile gpointer retval;
3020
+ } GOnce;
3021
+ </pre>
3022
+ <p>
3023
+ A <a class="link" href="glib-Threads.html#GOnce" title="GOnce"><span class="type">GOnce</span></a> struct controls a one-time initialization function. Any
3024
+ one-time initialization function must have its own unique <a class="link" href="glib-Threads.html#GOnce" title="GOnce"><span class="type">GOnce</span></a>
3025
+ struct.
3026
+ </p>
3027
+ <div class="variablelist"><table border="0">
3028
+ <col align="left" valign="top">
3029
+ <tbody>
3030
+ <tr>
3031
+ <td><p><span class="term">volatile <a class="link" href="glib-Threads.html#GOnceStatus" title="enum GOnceStatus"><span class="type">GOnceStatus</span></a> <em class="structfield"><code><a name="GOnce.status"></a>status</code></em>;</span></p></td>
3032
+ <td>the status of the <a class="link" href="glib-Threads.html#GOnce" title="GOnce"><span class="type">GOnce</span></a>
3033
+ </td>
3034
+ </tr>
3035
+ <tr>
3036
+ <td><p><span class="term">volatile <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> <em class="structfield"><code><a name="GOnce.retval"></a>retval</code></em>;</span></p></td>
3037
+ <td>the value returned by the call to the function, if <em class="parameter"><code>status</code></em>
3038
+ is <a class="link" href="glib-Threads.html#G-ONCE-STATUS-READY:CAPS"><code class="literal">G_ONCE_STATUS_READY</code></a>
3039
+ </td>
3040
+ </tr>
3041
+ </tbody>
3042
+ </table></div>
3043
+ <p class="since">Since 2.4</p>
3044
+ </div>
3045
+ <hr>
3046
+ <div class="refsect2" title="enum GOnceStatus">
3047
+ <a name="GOnceStatus"></a><h3>enum GOnceStatus</h3>
3048
+ <pre class="programlisting">typedef enum
3049
+ {
3050
+ G_ONCE_STATUS_NOTCALLED,
3051
+ G_ONCE_STATUS_PROGRESS,
3052
+ G_ONCE_STATUS_READY
3053
+ } GOnceStatus;
3054
+ </pre>
3055
+ <p>
3056
+ The possible statuses of a one-time initialization function
3057
+ controlled by a <a class="link" href="glib-Threads.html#GOnce" title="GOnce"><span class="type">GOnce</span></a> struct.
3058
+ </p>
3059
+ <div class="variablelist"><table border="0">
3060
+ <col align="left" valign="top">
3061
+ <tbody>
3062
+ <tr>
3063
+ <td><p><a name="G-ONCE-STATUS-NOTCALLED:CAPS"></a><span class="term"><code class="literal">G_ONCE_STATUS_NOTCALLED</code></span></p></td>
3064
+ <td>the function has not been called yet.
3065
+ </td>
3066
+ </tr>
3067
+ <tr>
3068
+ <td><p><a name="G-ONCE-STATUS-PROGRESS:CAPS"></a><span class="term"><code class="literal">G_ONCE_STATUS_PROGRESS</code></span></p></td>
3069
+ <td>the function call is currently in progress.
3070
+ </td>
3071
+ </tr>
3072
+ <tr>
3073
+ <td><p><a name="G-ONCE-STATUS-READY:CAPS"></a><span class="term"><code class="literal">G_ONCE_STATUS_READY</code></span></p></td>
3074
+ <td>the function has been called.
3075
+ </td>
3076
+ </tr>
3077
+ </tbody>
3078
+ </table></div>
3079
+ <p class="since">Since 2.4</p>
3080
+ </div>
3081
+ <hr>
3082
+ <div class="refsect2" title="G_ONCE_INIT">
3083
+ <a name="G-ONCE-INIT:CAPS"></a><h3>G_ONCE_INIT</h3>
3084
+ <pre class="programlisting">#define G_ONCE_INIT { G_ONCE_STATUS_NOTCALLED, NULL }
3085
+ </pre>
3086
+ <p>
3087
+ A <a class="link" href="glib-Threads.html#GOnce" title="GOnce"><span class="type">GOnce</span></a> must be initialized with this macro before it can be used.
3088
+ </p>
3089
+ <p>
3090
+ </p>
3091
+ <div class="informalexample">
3092
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
3093
+ <tbody>
3094
+ <tr>
3095
+ <td class="listing_lines" align="right"><pre>1</pre></td>
3096
+ <td class="listing_code"><pre class="programlisting"><span class="usertype">GOnce</span><span class="normal"> my_once </span><span class="symbol">=</span><span class="normal"> <a href="glib-Threads.html#G-ONCE-INIT:CAPS">G_ONCE_INIT</a></span><span class="symbol">;</span></pre></td>
3097
+ </tr>
3098
+ </tbody>
3099
+ </table>
3100
+ </div>
3101
+
3102
+ <p>
3103
+ </p>
3104
+ <p class="since">Since 2.4</p>
3105
+ </div>
3106
+ <hr>
3107
+ <div class="refsect2" title="g_once()">
3108
+ <a name="g-once"></a><h3>g_once()</h3>
3109
+ <pre class="programlisting">#define g_once(once, func, arg)</pre>
3110
+ <p>
3111
+ The first call to this routine by a process with a given <a class="link" href="glib-Threads.html#GOnce" title="GOnce"><span class="type">GOnce</span></a>
3112
+ struct calls <em class="parameter"><code>func</code></em> with the given argument. Thereafter, subsequent
3113
+ calls to <a class="link" href="glib-Threads.html#g-once" title="g_once()"><code class="function">g_once()</code></a> with the same <a class="link" href="glib-Threads.html#GOnce" title="GOnce"><span class="type">GOnce</span></a> struct do not call <em class="parameter"><code>func</code></em>
3114
+ again, but return the stored result of the first call. On return
3115
+ from <a class="link" href="glib-Threads.html#g-once" title="g_once()"><code class="function">g_once()</code></a>, the status of <em class="parameter"><code>once</code></em> will be <a class="link" href="glib-Threads.html#G-ONCE-STATUS-READY:CAPS"><code class="literal">G_ONCE_STATUS_READY</code></a>.
3116
+ </p>
3117
+ <p>
3118
+ For example, a mutex or a thread-specific data key must be created
3119
+ exactly once. In a threaded environment, calling <a class="link" href="glib-Threads.html#g-once" title="g_once()"><code class="function">g_once()</code></a> ensures
3120
+ that the initialization is serialized across multiple threads.
3121
+ </p>
3122
+ <p>
3123
+ </p>
3124
+ <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
3125
+ <h3 class="title">Note</h3>
3126
+ <p>Calling <a class="link" href="glib-Threads.html#g-once" title="g_once()"><code class="function">g_once()</code></a> recursively on the same <a class="link" href="glib-Threads.html#GOnce" title="GOnce"><span class="type">GOnce</span></a> struct in
3127
+ <em class="parameter"><code>func</code></em> will lead to a deadlock.</p>
3128
+ </div>
3129
+ <p>
3130
+ </p>
3131
+ <p>
3132
+ </p>
3133
+ <div class="informalexample">
3134
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
3135
+ <tbody>
3136
+ <tr>
3137
+ <td class="listing_lines" align="right"><pre>1
3138
+ 2
3139
+ 3
3140
+ 4
3141
+ 5
3142
+ 6
3143
+ 7
3144
+ 8
3145
+ 9</pre></td>
3146
+ <td class="listing_code"><pre class="programlisting"><span class="normal"><a href="glib-Basic-Types.html#gpointer">gpointer</a></span>
3147
+ <span class="function">get_debug_flags</span><span class="normal"> </span><span class="symbol">(</span><span class="type">void</span><span class="symbol">)</span>
3148
+ <span class="cbracket">{</span>
3149
+ <span class="normal"> </span><span class="keyword">static</span><span class="normal"> </span><span class="usertype">GOnce</span><span class="normal"> my_once </span><span class="symbol">=</span><span class="normal"> <a href="glib-Threads.html#G-ONCE-INIT:CAPS">G_ONCE_INIT</a></span><span class="symbol">;</span>
3150
+
3151
+ <span class="normal"> </span><span class="function"><a href="glib-Threads.html#g-once">g_once</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">my_once</span><span class="symbol">,</span><span class="normal"> parse_debug_flags</span><span class="symbol">,</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
3152
+
3153
+ <span class="normal"> </span><span class="keyword">return</span><span class="normal"> my_once</span><span class="symbol">.</span><span class="normal">retval</span><span class="symbol">;</span>
3154
+ <span class="cbracket">}</span></pre></td>
3155
+ </tr>
3156
+ </tbody>
3157
+ </table>
3158
+ </div>
3159
+
3160
+ <p>
3161
+ </p>
3162
+ <div class="variablelist"><table border="0">
3163
+ <col align="left" valign="top">
3164
+ <tbody>
3165
+ <tr>
3166
+ <td><p><span class="term"><em class="parameter"><code>once</code></em> :</span></p></td>
3167
+ <td>a <a class="link" href="glib-Threads.html#GOnce" title="GOnce"><span class="type">GOnce</span></a> structure
3168
+ </td>
3169
+ </tr>
3170
+ <tr>
3171
+ <td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
3172
+ <td>the <a class="link" href="glib-Threads.html#GThreadFunc" title="GThreadFunc ()"><span class="type">GThreadFunc</span></a> function associated to <em class="parameter"><code>once</code></em>. This function
3173
+ is called only once, regardless of the number of times it and
3174
+ its associated <a class="link" href="glib-Threads.html#GOnce" title="GOnce"><span class="type">GOnce</span></a> struct are passed to <a class="link" href="glib-Threads.html#g-once" title="g_once()"><code class="function">g_once()</code></a>.
3175
+ </td>
3176
+ </tr>
3177
+ <tr>
3178
+ <td><p><span class="term"><em class="parameter"><code>arg</code></em> :</span></p></td>
3179
+ <td>data to be passed to <em class="parameter"><code>func</code></em>
3180
+ </td>
3181
+ </tr>
3182
+ </tbody>
3183
+ </table></div>
3184
+ <p class="since">Since 2.4</p>
3185
+ </div>
3186
+ <hr>
3187
+ <div class="refsect2" title="g_once_init_enter ()">
3188
+ <a name="g-once-init-enter"></a><h3>g_once_init_enter ()</h3>
3189
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_once_init_enter (<em class="parameter"><code>volatile <a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *value_location</code></em>);</pre>
3190
+ <p>
3191
+ Function to be called when starting a critical initialization
3192
+ section. The argument <em class="parameter"><code>value_location</code></em> must point to a static
3193
+ 0-initialized variable that will be set to a value other than 0 at
3194
+ the end of the initialization section. In combination with
3195
+ <a class="link" href="glib-Threads.html#g-once-init-leave" title="g_once_init_leave ()"><code class="function">g_once_init_leave()</code></a> and the unique address <em class="parameter"><code>value_location</code></em>, it can
3196
+ be ensured that an initialization section will be executed only once
3197
+ during a program's life time, and that concurrent threads are
3198
+ blocked until initialization completed. To be used in constructs
3199
+ like this:
3200
+ </p>
3201
+ <p>
3202
+ </p>
3203
+ <div class="informalexample">
3204
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
3205
+ <tbody>
3206
+ <tr>
3207
+ <td class="listing_lines" align="right"><pre>1
3208
+ 2
3209
+ 3
3210
+ 4
3211
+ 5
3212
+ 6
3213
+ 7
3214
+ 8
3215
+ 9
3216
+ 10</pre></td>
3217
+ <td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> </span><span class="usertype">gsize</span><span class="normal"> initialization_value </span><span class="symbol">=</span><span class="normal"> </span><span class="number">0</span><span class="symbol">;</span>
3218
+
3219
+ <span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="glib-Threads.html#g-once-init-enter">g_once_init_enter</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">initialization_value</span><span class="symbol">))</span>
3220
+ <span class="normal"> </span><span class="cbracket">{</span>
3221
+ <span class="normal"> </span><span class="usertype">gsize</span><span class="normal"> setup_value </span><span class="symbol">=</span><span class="normal"> </span><span class="number">42</span><span class="symbol">;</span><span class="normal"> </span><span class="comment">/* initialization code here */</span>
3222
+
3223
+ <span class="normal"> </span><span class="function"><a href="glib-Threads.html#g-once-init-leave">g_once_init_leave</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">initialization_value</span><span class="symbol">,</span><span class="normal"> setup_value</span><span class="symbol">);</span>
3224
+ <span class="normal"> </span><span class="cbracket">}</span>
3225
+
3226
+ <span class="comment">/* use initialization_value here */</span></pre></td>
3227
+ </tr>
3228
+ </tbody>
3229
+ </table>
3230
+ </div>
3231
+
3232
+ <p>
3233
+ </p>
3234
+ <div class="variablelist"><table border="0">
3235
+ <col align="left" valign="top">
3236
+ <tbody>
3237
+ <tr>
3238
+ <td><p><span class="term"><em class="parameter"><code>value_location</code></em> :</span></p></td>
3239
+ <td>location of a static initializable variable
3240
+ containing 0.
3241
+ </td>
3242
+ </tr>
3243
+ <tr>
3244
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3245
+ <td>
3246
+ <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the initialization section should be entered,
3247
+ <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> and blocks otherwise
3248
+ </td>
3249
+ </tr>
3250
+ </tbody>
3251
+ </table></div>
3252
+ <p class="since">Since 2.14</p>
3253
+ </div>
3254
+ <hr>
3255
+ <div class="refsect2" title="g_once_init_leave ()">
3256
+ <a name="g-once-init-leave"></a><h3>g_once_init_leave ()</h3>
3257
+ <pre class="programlisting"><span class="returnvalue">void</span> g_once_init_leave (<em class="parameter"><code>volatile <a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *value_location</code></em>,
3258
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> initialization_value</code></em>);</pre>
3259
+ <p>
3260
+ Counterpart to <a class="link" href="glib-Threads.html#g-once-init-enter" title="g_once_init_enter ()"><code class="function">g_once_init_enter()</code></a>. Expects a location of a static
3261
+ 0-initialized initialization variable, and an initialization value
3262
+ other than 0. Sets the variable to the initialization value, and
3263
+ releases concurrent threads blocking in <a class="link" href="glib-Threads.html#g-once-init-enter" title="g_once_init_enter ()"><code class="function">g_once_init_enter()</code></a> on this
3264
+ initialization variable.
3265
+ </p>
3266
+ <div class="variablelist"><table border="0">
3267
+ <col align="left" valign="top">
3268
+ <tbody>
3269
+ <tr>
3270
+ <td><p><span class="term"><em class="parameter"><code>value_location</code></em> :</span></p></td>
3271
+ <td>location of a static initializable variable
3272
+ containing 0.
3273
+ </td>
3274
+ </tr>
3275
+ <tr>
3276
+ <td><p><span class="term"><em class="parameter"><code>initialization_value</code></em> :</span></p></td>
3277
+ <td>new non-0 value for *<em class="parameter"><code>value_location</code></em>.
3278
+ </td>
3279
+ </tr>
3280
+ </tbody>
3281
+ </table></div>
3282
+ <p class="since">Since 2.14</p>
3283
+ </div>
3284
+ <hr>
3285
+ <div class="refsect2" title="g_bit_lock ()">
3286
+ <a name="g-bit-lock"></a><h3>g_bit_lock ()</h3>
3287
+ <pre class="programlisting"><span class="returnvalue">void</span> g_bit_lock (<em class="parameter"><code>volatile <a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> *address</code></em>,
3288
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> lock_bit</code></em>);</pre>
3289
+ <p>
3290
+ Sets the indicated <em class="parameter"><code>lock_bit</code></em> in <em class="parameter"><code>address</code></em>. If the bit is already
3291
+ set, this call will block until <a class="link" href="glib-Threads.html#g-bit-unlock" title="g_bit_unlock ()"><code class="function">g_bit_unlock()</code></a> unsets the
3292
+ corresponding bit.
3293
+ </p>
3294
+ <p>
3295
+ Attempting to lock on two different bits within the same integer is
3296
+ not supported and will very probably cause deadlocks.
3297
+ </p>
3298
+ <p>
3299
+ The value of the bit that is set is (1u &lt;&lt; <em class="parameter"><code>bit</code></em>). If <em class="parameter"><code>bit</code></em> is not
3300
+ between 0 and 31 then the result is undefined.
3301
+ </p>
3302
+ <p>
3303
+ This function accesses <em class="parameter"><code>address</code></em> atomically. All other accesses to
3304
+ <em class="parameter"><code>address</code></em> must be atomic in order for this function to work
3305
+ reliably.
3306
+ </p>
3307
+ <div class="variablelist"><table border="0">
3308
+ <col align="left" valign="top">
3309
+ <tbody>
3310
+ <tr>
3311
+ <td><p><span class="term"><em class="parameter"><code>address</code></em> :</span></p></td>
3312
+ <td>a pointer to an integer
3313
+ </td>
3314
+ </tr>
3315
+ <tr>
3316
+ <td><p><span class="term"><em class="parameter"><code>lock_bit</code></em> :</span></p></td>
3317
+ <td>a bit value between 0 and 31
3318
+ </td>
3319
+ </tr>
3320
+ </tbody>
3321
+ </table></div>
3322
+ <p class="since">Since 2.24</p>
3323
+ </div>
3324
+ <hr>
3325
+ <div class="refsect2" title="g_bit_trylock ()">
3326
+ <a name="g-bit-trylock"></a><h3>g_bit_trylock ()</h3>
3327
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_bit_trylock (<em class="parameter"><code>volatile <a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> *address</code></em>,
3328
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> lock_bit</code></em>);</pre>
3329
+ <p>
3330
+ Sets the indicated <em class="parameter"><code>lock_bit</code></em> in <em class="parameter"><code>address</code></em>, returning <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if
3331
+ successful. If the bit is already set, returns <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> immediately.
3332
+ </p>
3333
+ <p>
3334
+ Attempting to lock on two different bits within the same integer is
3335
+ not supported.
3336
+ </p>
3337
+ <p>
3338
+ The value of the bit that is set is (1u &lt;&lt; <em class="parameter"><code>bit</code></em>). If <em class="parameter"><code>bit</code></em> is not
3339
+ between 0 and 31 then the result is undefined.
3340
+ </p>
3341
+ <p>
3342
+ This function accesses <em class="parameter"><code>address</code></em> atomically. All other accesses to
3343
+ <em class="parameter"><code>address</code></em> must be atomic in order for this function to work
3344
+ reliably.
3345
+ </p>
3346
+ <div class="variablelist"><table border="0">
3347
+ <col align="left" valign="top">
3348
+ <tbody>
3349
+ <tr>
3350
+ <td><p><span class="term"><em class="parameter"><code>address</code></em> :</span></p></td>
3351
+ <td>a pointer to an integer
3352
+ </td>
3353
+ </tr>
3354
+ <tr>
3355
+ <td><p><span class="term"><em class="parameter"><code>lock_bit</code></em> :</span></p></td>
3356
+ <td>a bit value between 0 and 31
3357
+ </td>
3358
+ </tr>
3359
+ <tr>
3360
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3361
+ <td>
3362
+ <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the lock was acquired
3363
+ </td>
3364
+ </tr>
3365
+ </tbody>
3366
+ </table></div>
3367
+ <p class="since">Since 2.24</p>
3368
+ </div>
3369
+ <hr>
3370
+ <div class="refsect2" title="g_bit_unlock ()">
3371
+ <a name="g-bit-unlock"></a><h3>g_bit_unlock ()</h3>
3372
+ <pre class="programlisting"><span class="returnvalue">void</span> g_bit_unlock (<em class="parameter"><code>volatile <a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> *address</code></em>,
3373
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> lock_bit</code></em>);</pre>
3374
+ <p>
3375
+ Clears the indicated <em class="parameter"><code>lock_bit</code></em> in <em class="parameter"><code>address</code></em>. If another thread is
3376
+ currently blocked in <a class="link" href="glib-Threads.html#g-bit-lock" title="g_bit_lock ()"><code class="function">g_bit_lock()</code></a> on this same bit then it will be
3377
+ woken up.
3378
+ </p>
3379
+ <p>
3380
+ This function accesses <em class="parameter"><code>address</code></em> atomically. All other accesses to
3381
+ <em class="parameter"><code>address</code></em> must be atomic in order for this function to work
3382
+ reliably.
3383
+ </p>
3384
+ <div class="variablelist"><table border="0">
3385
+ <col align="left" valign="top">
3386
+ <tbody>
3387
+ <tr>
3388
+ <td><p><span class="term"><em class="parameter"><code>address</code></em> :</span></p></td>
3389
+ <td>a pointer to an integer
3390
+ </td>
3391
+ </tr>
3392
+ <tr>
3393
+ <td><p><span class="term"><em class="parameter"><code>lock_bit</code></em> :</span></p></td>
3394
+ <td>a bit value between 0 and 31
3395
+ </td>
3396
+ </tr>
3397
+ </tbody>
3398
+ </table></div>
3399
+ <p class="since">Since 2.24</p>
3400
+ </div>
3401
+ </div>
3402
+ <div class="refsect1" title="See Also">
3403
+ <a name="glib-Threads.see-also"></a><h2>See Also</h2>
3404
+ <a class="link" href="glib-Thread-Pools.html#GThreadPool" title="GThreadPool"><span class="type">GThreadPool</span></a>, <a class="link" href="glib-Asynchronous-Queues.html#GAsyncQueue" title="GAsyncQueue"><span class="type">GAsyncQueue</span></a>
3405
+ </div>
3406
+ </div>
3407
+ <div class="footer">
3408
+ <hr>
3409
+ Generated by GTK-Doc V1.14</div>
3410
+ </body>
3411
+ </html>