glib2 0.90.2-x86-mingw32

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (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
data/vendor/local/share/gtk-doc/html/glib/glib-GVariant.html ADDED
@@ -0,0 +1,3798 @@
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>GVariant</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-data-types.html" title="GLib Data Types">
9
+ <link rel="prev" href="glib-GVariantType.html" title="GVariantType">
10
+ <link rel="next" href="gvariant-format-strings.html" title="GVariant Format Strings">
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-GVariantType.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18
+ <td><a accesskey="u" href="glib-data-types.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="gvariant-format-strings.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-GVariant.synopsis" class="shortcut">Top</a>
25
+  | 
26
+ <a href="#glib-GVariant.description" class="shortcut">Description</a>
27
+ </td></tr>
28
+ </table>
29
+ <div class="refentry" title="GVariant">
30
+ <a name="glib-GVariant"></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-GVariant.top_of_page"></a>GVariant</span></h2>
34
+ <p>GVariant — strongly typed value datatype</p>
35
+ </td>
36
+ <td valign="top" align="right"></td>
37
+ </tr></table></div>
38
+ <div class="refsynopsisdiv" title="Synopsis">
39
+ <a name="glib-GVariant.synopsis"></a><h2>Synopsis</h2>
40
+ <pre class="synopsis">
41
+ #include &lt;glib.h&gt;
42
+
43
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant">GVariant</a>;
44
+ <span class="returnvalue">void</span> <a class="link" href="glib-GVariant.html#g-variant-unref" title="g_variant_unref ()">g_variant_unref</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);
45
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="glib-GVariant.html#g-variant-ref" title="g_variant_ref ()">g_variant_ref</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);
46
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="glib-GVariant.html#g-variant-ref-sink" title="g_variant_ref_sink ()">g_variant_ref_sink</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);
47
+ const <a class="link" href="glib-GVariantType.html#GVariantType" title="GVariantType"><span class="returnvalue">GVariantType</span></a> * <a class="link" href="glib-GVariant.html#g-variant-get-type" title="g_variant_get_type ()">g_variant_get_type</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);
48
+ const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-GVariant.html#g-variant-get-type-string" title="g_variant_get_type_string ()">g_variant_get_type_string</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);
49
+ <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-GVariant.html#g-variant-is-of-type" title="g_variant_is_of_type ()">g_variant_is_of_type</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>,
50
+ <em class="parameter"><code>const <a class="link" href="glib-GVariantType.html#GVariantType" title="GVariantType"><span class="type">GVariantType</span></a> *type</code></em>);
51
+ <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-GVariant.html#g-variant-is-container" title="g_variant_is_container ()">g_variant_is_container</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);
52
+
53
+ <a class="link" href="glib-GVariant.html#GVariantClass" title="enum GVariantClass"><span class="returnvalue">GVariantClass</span></a> <a class="link" href="glib-GVariant.html#g-variant-classify" title="g_variant_classify ()">g_variant_classify</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);
54
+ enum <a class="link" href="glib-GVariant.html#GVariantClass" title="enum GVariantClass">GVariantClass</a>;
55
+
56
+ <span class="returnvalue">void</span> <a class="link" href="glib-GVariant.html#g-variant-get" title="g_variant_get ()">g_variant_get</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>,
57
+ <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *format_string</code></em>,
58
+ <em class="parameter"><code>...</code></em>);
59
+ <span class="returnvalue">void</span> <a class="link" href="glib-GVariant.html#g-variant-get-va" title="g_variant_get_va ()">g_variant_get_va</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>,
60
+ <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *format_string</code></em>,
61
+ <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **endptr</code></em>,
62
+ <em class="parameter"><code><span class="type">va_list</span> *app</code></em>);
63
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="glib-GVariant.html#g-variant-new" title="g_variant_new ()">g_variant_new</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *format_string</code></em>,
64
+ <em class="parameter"><code>...</code></em>);
65
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="glib-GVariant.html#g-variant-new-va" title="g_variant_new_va ()">g_variant_new_va</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *format_string</code></em>,
66
+ <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **endptr</code></em>,
67
+ <em class="parameter"><code><span class="type">va_list</span> *app</code></em>);
68
+
69
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="glib-GVariant.html#g-variant-new-boolean" title="g_variant_new_boolean ()">g_variant_new_boolean</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="type">gboolean</span></a> boolean</code></em>);
70
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="glib-GVariant.html#g-variant-new-byte" title="g_variant_new_byte ()">g_variant_new_byte</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guchar" title="guchar"><span class="type">guchar</span></a> byte</code></em>);
71
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="glib-GVariant.html#g-variant-new-int16" title="g_variant_new_int16 ()">g_variant_new_int16</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint16" title="gint16"><span class="type">gint16</span></a> int16</code></em>);
72
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="glib-GVariant.html#g-variant-new-uint16" title="g_variant_new_uint16 ()">g_variant_new_uint16</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint16" title="guint16"><span class="type">guint16</span></a> uint16</code></em>);
73
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="glib-GVariant.html#g-variant-new-int32" title="g_variant_new_int32 ()">g_variant_new_int32</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint32" title="gint32"><span class="type">gint32</span></a> int32</code></em>);
74
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="glib-GVariant.html#g-variant-new-uint32" title="g_variant_new_uint32 ()">g_variant_new_uint32</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint32" title="guint32"><span class="type">guint32</span></a> uint32</code></em>);
75
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="glib-GVariant.html#g-variant-new-int64" title="g_variant_new_int64 ()">g_variant_new_int64</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint64" title="gint64"><span class="type">gint64</span></a> int64</code></em>);
76
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="glib-GVariant.html#g-variant-new-uint64" title="g_variant_new_uint64 ()">g_variant_new_uint64</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint64" title="guint64"><span class="type">guint64</span></a> uint64</code></em>);
77
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="glib-GVariant.html#g-variant-new-handle" title="g_variant_new_handle ()">g_variant_new_handle</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint32" title="gint32"><span class="type">gint32</span></a> handle</code></em>);
78
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="glib-GVariant.html#g-variant-new-double" title="g_variant_new_double ()">g_variant_new_double</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gdouble" title="gdouble"><span class="type">gdouble</span></a> floating</code></em>);
79
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="glib-GVariant.html#g-variant-new-string" title="g_variant_new_string ()">g_variant_new_string</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *string</code></em>);
80
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="glib-GVariant.html#g-variant-new-object-path" title="g_variant_new_object_path ()">g_variant_new_object_path</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *object_path</code></em>);
81
+ <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-GVariant.html#g-variant-is-object-path" title="g_variant_is_object_path ()">g_variant_is_object_path</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *string</code></em>);
82
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="glib-GVariant.html#g-variant-new-signature" title="g_variant_new_signature ()">g_variant_new_signature</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *signature</code></em>);
83
+ <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-GVariant.html#g-variant-is-signature" title="g_variant_is_signature ()">g_variant_is_signature</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *string</code></em>);
84
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="glib-GVariant.html#g-variant-new-variant" title="g_variant_new_variant ()">g_variant_new_variant</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);
85
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="glib-GVariant.html#g-variant-new-strv" title="g_variant_new_strv ()">g_variant_new_strv</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> * const *strv</code></em>,
86
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> length</code></em>);
87
+
88
+ <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-GVariant.html#g-variant-get-boolean" title="g_variant_get_boolean ()">g_variant_get_boolean</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);
89
+ <a class="link" href="glib-Basic-Types.html#guchar" title="guchar"><span class="returnvalue">guchar</span></a> <a class="link" href="glib-GVariant.html#g-variant-get-byte" title="g_variant_get_byte ()">g_variant_get_byte</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);
90
+ <a class="link" href="glib-Basic-Types.html#gint16" title="gint16"><span class="returnvalue">gint16</span></a> <a class="link" href="glib-GVariant.html#g-variant-get-int16" title="g_variant_get_int16 ()">g_variant_get_int16</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);
91
+ <a class="link" href="glib-Basic-Types.html#guint16" title="guint16"><span class="returnvalue">guint16</span></a> <a class="link" href="glib-GVariant.html#g-variant-get-uint16" title="g_variant_get_uint16 ()">g_variant_get_uint16</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);
92
+ <a class="link" href="glib-Basic-Types.html#gint32" title="gint32"><span class="returnvalue">gint32</span></a> <a class="link" href="glib-GVariant.html#g-variant-get-int32" title="g_variant_get_int32 ()">g_variant_get_int32</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);
93
+ <a class="link" href="glib-Basic-Types.html#guint32" title="guint32"><span class="returnvalue">guint32</span></a> <a class="link" href="glib-GVariant.html#g-variant-get-uint32" title="g_variant_get_uint32 ()">g_variant_get_uint32</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);
94
+ <a class="link" href="glib-Basic-Types.html#gint64" title="gint64"><span class="returnvalue">gint64</span></a> <a class="link" href="glib-GVariant.html#g-variant-get-int64" title="g_variant_get_int64 ()">g_variant_get_int64</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);
95
+ <a class="link" href="glib-Basic-Types.html#guint64" title="guint64"><span class="returnvalue">guint64</span></a> <a class="link" href="glib-GVariant.html#g-variant-get-uint64" title="g_variant_get_uint64 ()">g_variant_get_uint64</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);
96
+ <a class="link" href="glib-Basic-Types.html#gint32" title="gint32"><span class="returnvalue">gint32</span></a> <a class="link" href="glib-GVariant.html#g-variant-get-handle" title="g_variant_get_handle ()">g_variant_get_handle</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);
97
+ <a class="link" href="glib-Basic-Types.html#gdouble" title="gdouble"><span class="returnvalue">gdouble</span></a> <a class="link" href="glib-GVariant.html#g-variant-get-double" title="g_variant_get_double ()">g_variant_get_double</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);
98
+ const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-GVariant.html#g-variant-get-string" title="g_variant_get_string ()">g_variant_get_string</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>,
99
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *length</code></em>);
100
+ <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-GVariant.html#g-variant-dup-string" title="g_variant_dup_string ()">g_variant_dup_string</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>,
101
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *length</code></em>);
102
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="glib-GVariant.html#g-variant-get-variant" title="g_variant_get_variant ()">g_variant_get_variant</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);
103
+ const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> ** <a class="link" href="glib-GVariant.html#g-variant-get-strv" title="g_variant_get_strv ()">g_variant_get_strv</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>,
104
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *length</code></em>);
105
+ <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> ** <a class="link" href="glib-GVariant.html#g-variant-dup-strv" title="g_variant_dup_strv ()">g_variant_dup_strv</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>,
106
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *length</code></em>);
107
+
108
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="glib-GVariant.html#g-variant-new-maybe" title="g_variant_new_maybe ()">g_variant_new_maybe</a> (<em class="parameter"><code>const <a class="link" href="glib-GVariantType.html#GVariantType" title="GVariantType"><span class="type">GVariantType</span></a> *child_type</code></em>,
109
+ <em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *child</code></em>);
110
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="glib-GVariant.html#g-variant-new-array" title="g_variant_new_array ()">g_variant_new_array</a> (<em class="parameter"><code>const <a class="link" href="glib-GVariantType.html#GVariantType" title="GVariantType"><span class="type">GVariantType</span></a> *child_type</code></em>,
111
+ <em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> * const *children</code></em>,
112
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> n_children</code></em>);
113
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="glib-GVariant.html#g-variant-new-tuple" title="g_variant_new_tuple ()">g_variant_new_tuple</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> * const *children</code></em>,
114
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> n_children</code></em>);
115
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="glib-GVariant.html#g-variant-new-dict-entry" title="g_variant_new_dict_entry ()">g_variant_new_dict_entry</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *key</code></em>,
116
+ <em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);
117
+
118
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="glib-GVariant.html#g-variant-get-maybe" title="g_variant_get_maybe ()">g_variant_get_maybe</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);
119
+ <a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="returnvalue">gsize</span></a> <a class="link" href="glib-GVariant.html#g-variant-n-children" title="g_variant_n_children ()">g_variant_n_children</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);
120
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="glib-GVariant.html#g-variant-get-child-value" title="g_variant_get_child_value ()">g_variant_get_child_value</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>,
121
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> index_</code></em>);
122
+ <span class="returnvalue">void</span> <a class="link" href="glib-GVariant.html#g-variant-get-child" title="g_variant_get_child ()">g_variant_get_child</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>,
123
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> index_</code></em>,
124
+ <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *format_string</code></em>,
125
+ <em class="parameter"><code>...</code></em>);
126
+ <a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer"><span class="returnvalue">gconstpointer</span></a> <a class="link" href="glib-GVariant.html#g-variant-get-fixed-array" title="g_variant_get_fixed_array ()">g_variant_get_fixed_array</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>,
127
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *n_elements</code></em>,
128
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> element_size</code></em>);
129
+
130
+ <a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="returnvalue">gsize</span></a> <a class="link" href="glib-GVariant.html#g-variant-get-size" title="g_variant_get_size ()">g_variant_get_size</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);
131
+ <a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer"><span class="returnvalue">gconstpointer</span></a> <a class="link" href="glib-GVariant.html#g-variant-get-data" title="g_variant_get_data ()">g_variant_get_data</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);
132
+ <span class="returnvalue">void</span> <a class="link" href="glib-GVariant.html#g-variant-store" title="g_variant_store ()">g_variant_store</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>,
133
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> data</code></em>);
134
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="glib-GVariant.html#g-variant-new-from-data" title="g_variant_new_from_data ()">g_variant_new_from_data</a> (<em class="parameter"><code>const <a class="link" href="glib-GVariantType.html#GVariantType" title="GVariantType"><span class="type">GVariantType</span></a> *type</code></em>,
135
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer"><span class="type">gconstpointer</span></a> data</code></em>,
136
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> size</code></em>,
137
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="type">gboolean</span></a> trusted</code></em>,
138
+ <em class="parameter"><code><a class="link" href="glib-Datasets.html#GDestroyNotify" title="GDestroyNotify ()"><span class="type">GDestroyNotify</span></a> notify</code></em>,
139
+ <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>);
140
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="glib-GVariant.html#g-variant-byteswap" title="g_variant_byteswap ()">g_variant_byteswap</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);
141
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="glib-GVariant.html#g-variant-get-normal-form" title="g_variant_get_normal_form ()">g_variant_get_normal_form</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);
142
+ <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-GVariant.html#g-variant-is-normal-form" title="g_variant_is_normal_form ()">g_variant_is_normal_form</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);
143
+
144
+ <a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="returnvalue">guint</span></a> <a class="link" href="glib-GVariant.html#g-variant-hash" title="g_variant_hash ()">g_variant_hash</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer"><span class="type">gconstpointer</span></a> value</code></em>);
145
+ <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-GVariant.html#g-variant-equal" title="g_variant_equal ()">g_variant_equal</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer"><span class="type">gconstpointer</span></a> one</code></em>,
146
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer"><span class="type">gconstpointer</span></a> two</code></em>);
147
+
148
+ <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-GVariant.html#g-variant-print" title="g_variant_print ()">g_variant_print</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>,
149
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="type">gboolean</span></a> type_annotate</code></em>);
150
+ <a class="link" href="glib-Strings.html#GString" title="GString"><span class="returnvalue">GString</span></a> * <a class="link" href="glib-GVariant.html#g-variant-print-string" title="g_variant_print_string ()">g_variant_print_string</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>,
151
+ <em class="parameter"><code><a class="link" href="glib-Strings.html#GString" title="GString"><span class="type">GString</span></a> *string</code></em>,
152
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="type">gboolean</span></a> type_annotate</code></em>);
153
+
154
+ <a class="link" href="glib-GVariant.html#GVariantIter" title="GVariantIter">GVariantIter</a>;
155
+ <a class="link" href="glib-GVariant.html#GVariantIter" title="GVariantIter"><span class="returnvalue">GVariantIter</span></a> * <a class="link" href="glib-GVariant.html#g-variant-iter-copy" title="g_variant_iter_copy ()">g_variant_iter_copy</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariantIter" title="GVariantIter"><span class="type">GVariantIter</span></a> *iter</code></em>);
156
+ <span class="returnvalue">void</span> <a class="link" href="glib-GVariant.html#g-variant-iter-free" title="g_variant_iter_free ()">g_variant_iter_free</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariantIter" title="GVariantIter"><span class="type">GVariantIter</span></a> *iter</code></em>);
157
+ <a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="returnvalue">gsize</span></a> <a class="link" href="glib-GVariant.html#g-variant-iter-init" title="g_variant_iter_init ()">g_variant_iter_init</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariantIter" title="GVariantIter"><span class="type">GVariantIter</span></a> *iter</code></em>,
158
+ <em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);
159
+ <a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="returnvalue">gsize</span></a> <a class="link" href="glib-GVariant.html#g-variant-iter-n-children" title="g_variant_iter_n_children ()">g_variant_iter_n_children</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariantIter" title="GVariantIter"><span class="type">GVariantIter</span></a> *iter</code></em>);
160
+ <a class="link" href="glib-GVariant.html#GVariantIter" title="GVariantIter"><span class="returnvalue">GVariantIter</span></a> * <a class="link" href="glib-GVariant.html#g-variant-iter-new" title="g_variant_iter_new ()">g_variant_iter_new</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);
161
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="glib-GVariant.html#g-variant-iter-next-value" title="g_variant_iter_next_value ()">g_variant_iter_next_value</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariantIter" title="GVariantIter"><span class="type">GVariantIter</span></a> *iter</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-GVariant.html#g-variant-iter-next" title="g_variant_iter_next ()">g_variant_iter_next</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariantIter" title="GVariantIter"><span class="type">GVariantIter</span></a> *iter</code></em>,
163
+ <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *format_string</code></em>,
164
+ <em class="parameter"><code>...</code></em>);
165
+ <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-GVariant.html#g-variant-iter-loop" title="g_variant_iter_loop ()">g_variant_iter_loop</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariantIter" title="GVariantIter"><span class="type">GVariantIter</span></a> *iter</code></em>,
166
+ <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *format_string</code></em>,
167
+ <em class="parameter"><code>...</code></em>);
168
+
169
+ <a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder">GVariantBuilder</a>;
170
+ <span class="returnvalue">void</span> <a class="link" href="glib-GVariant.html#g-variant-builder-unref" title="g_variant_builder_unref ()">g_variant_builder_unref</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a> *builder</code></em>);
171
+ <a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="returnvalue">GVariantBuilder</span></a> * <a class="link" href="glib-GVariant.html#g-variant-builder-ref" title="g_variant_builder_ref ()">g_variant_builder_ref</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a> *builder</code></em>);
172
+ <a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="returnvalue">GVariantBuilder</span></a> * <a class="link" href="glib-GVariant.html#g-variant-builder-new" title="g_variant_builder_new ()">g_variant_builder_new</a> (<em class="parameter"><code>const <a class="link" href="glib-GVariantType.html#GVariantType" title="GVariantType"><span class="type">GVariantType</span></a> *type</code></em>);
173
+ <span class="returnvalue">void</span> <a class="link" href="glib-GVariant.html#g-variant-builder-init" title="g_variant_builder_init ()">g_variant_builder_init</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a> *builder</code></em>,
174
+ <em class="parameter"><code>const <a class="link" href="glib-GVariantType.html#GVariantType" title="GVariantType"><span class="type">GVariantType</span></a> *type</code></em>);
175
+ <span class="returnvalue">void</span> <a class="link" href="glib-GVariant.html#g-variant-builder-clear" title="g_variant_builder_clear ()">g_variant_builder_clear</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a> *builder</code></em>);
176
+ <span class="returnvalue">void</span> <a class="link" href="glib-GVariant.html#g-variant-builder-add-value" title="g_variant_builder_add_value ()">g_variant_builder_add_value</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a> *builder</code></em>,
177
+ <em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);
178
+ <span class="returnvalue">void</span> <a class="link" href="glib-GVariant.html#g-variant-builder-add" title="g_variant_builder_add ()">g_variant_builder_add</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a> *builder</code></em>,
179
+ <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *format_string</code></em>,
180
+ <em class="parameter"><code>...</code></em>);
181
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="glib-GVariant.html#g-variant-builder-end" title="g_variant_builder_end ()">g_variant_builder_end</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a> *builder</code></em>);
182
+ <span class="returnvalue">void</span> <a class="link" href="glib-GVariant.html#g-variant-builder-open" title="g_variant_builder_open ()">g_variant_builder_open</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a> *builder</code></em>,
183
+ <em class="parameter"><code>const <a class="link" href="glib-GVariantType.html#GVariantType" title="GVariantType"><span class="type">GVariantType</span></a> *type</code></em>);
184
+ <span class="returnvalue">void</span> <a class="link" href="glib-GVariant.html#g-variant-builder-close" title="g_variant_builder_close ()">g_variant_builder_close</a> (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a> *builder</code></em>);
185
+
186
+ #define <a class="link" href="glib-GVariant.html#G-VARIANT-PARSE-ERROR:CAPS" title="G_VARIANT_PARSE_ERROR">G_VARIANT_PARSE_ERROR</a>
187
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="glib-GVariant.html#g-variant-parse" title="g_variant_parse ()">g_variant_parse</a> (<em class="parameter"><code>const <a class="link" href="glib-GVariantType.html#GVariantType" title="GVariantType"><span class="type">GVariantType</span></a> *type</code></em>,
188
+ <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *text</code></em>,
189
+ <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *limit</code></em>,
190
+ <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **endptr</code></em>,
191
+ <em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);
192
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="glib-GVariant.html#g-variant-new-parsed-va" title="g_variant_new_parsed_va ()">g_variant_new_parsed_va</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *format</code></em>,
193
+ <em class="parameter"><code><span class="type">va_list</span> *app</code></em>);
194
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * <a class="link" href="glib-GVariant.html#g-variant-new-parsed" title="g_variant_new_parsed ()">g_variant_new_parsed</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *format</code></em>,
195
+ <em class="parameter"><code>...</code></em>);
196
+ </pre>
197
+ </div>
198
+ <div class="refsect1" title="Description">
199
+ <a name="glib-GVariant.description"></a><h2>Description</h2>
200
+ <p>
201
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> is a variant datatype; it stores a value along with
202
+ information about the type of that value. The range of possible
203
+ values is determined by the type. The type system used by <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>
204
+ is <a class="link" href="glib-GVariantType.html#GVariantType" title="GVariantType"><span class="type">GVariantType</span></a>.
205
+ </p>
206
+ <p>
207
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instances always have a type and a value (which are given
208
+ at construction time). The type and value of a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance
209
+ can never change other than by the <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> itself being
210
+ destroyed. A <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> can not contain a pointer.
211
+ </p>
212
+ <p>
213
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> is reference counted using <a class="link" href="glib-GVariant.html#g-variant-ref" title="g_variant_ref ()"><code class="function">g_variant_ref()</code></a> and
214
+ <a class="link" href="glib-GVariant.html#g-variant-unref" title="g_variant_unref ()"><code class="function">g_variant_unref()</code></a>. <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> also has floating reference counts --
215
+ see <a class="link" href="glib-GVariant.html#g-variant-ref-sink" title="g_variant_ref_sink ()"><code class="function">g_variant_ref_sink()</code></a>.
216
+ </p>
217
+ <p>
218
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> is completely threadsafe. A <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance can be
219
+ concurrently accessed in any way from any number of threads without
220
+ problems.
221
+ </p>
222
+ <p>
223
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> is heavily optimised for dealing with data in serialised
224
+ form. It works particularly well with data located in memory-mapped
225
+ files. It can perform nearly all deserialisation operations in a
226
+ small constant time, usually touching only a single memory page.
227
+ Serialised <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> data can also be sent over the network.
228
+ </p>
229
+ <p>
230
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> is largely compatible with DBus. Almost all types of
231
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instances can be sent over DBus. See <a class="link" href="glib-GVariantType.html#GVariantType" title="GVariantType"><span class="type">GVariantType</span></a> for
232
+ exceptions.
233
+ </p>
234
+ <p>
235
+ For convenience to C programmers, <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> features powerful
236
+ varargs-based value construction and destruction. This feature is
237
+ designed to be embedded in other libraries.
238
+ </p>
239
+ <p>
240
+ There is a Python-inspired text language for describing <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>
241
+ values. <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> includes a printer for this language and a parser
242
+ with type inferencing.
243
+ </p>
244
+ <div class="refsect2" title="Memory Use">
245
+ <a name="id898004"></a><h3>Memory Use</h3>
246
+ <p>
247
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> tries to be quite efficient with respect to memory use.
248
+ This section gives a rough idea of how much memory is used by the
249
+ current implementation. The information here is subject to change
250
+ in the future.
251
+ </p>
252
+ <p>
253
+ The memory allocated by <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> can be grouped into 4 broad
254
+ purposes: memory for serialised data, memory for the type
255
+ information cache, buffer management memory and memory for the
256
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> structure itself.
257
+ </p>
258
+ <div class="refsect3" title="Serialised Data Memory">
259
+ <a name="id921299"></a><h4>Serialised Data Memory</h4>
260
+ <p>
261
+ This is the memory that is used for storing GVariant data in
262
+ serialised form. This is what would be sent over the network or
263
+ what would end up on disk.
264
+ </p>
265
+ <p>
266
+ The amount of memory required to store a boolean is 1 byte. 16,
267
+ 32 and 64 bit integers and double precision floating point numbers
268
+ use their "natural" size. Strings (including object path and
269
+ signature strings) are stored with a nul terminator, and as such
270
+ use the length of the string plus 1 byte.
271
+ </p>
272
+ <p>
273
+ Maybe types use no space at all to represent the null value and
274
+ use the same amount of space (sometimes plus one byte) as the
275
+ equivalent non-maybe-typed value to represent the non-null case.
276
+ </p>
277
+ <p>
278
+ Arrays use the amount of space required to store each of their
279
+ members, concatenated. Additionally, if the items stored in an
280
+ array are not of a fixed-size (ie: strings, other arrays, etc)
281
+ then an additional framing offset is stored for each item. The
282
+ size of this offset is either 1, 2 or 4 bytes depending on the
283
+ overall size of the container. Additionally, extra padding bytes
284
+ are added as required for alignment of child values.
285
+ </p>
286
+ <p>
287
+ Tuples (including dictionary entries) use the amount of space
288
+ required to store each of their members, concatenated, plus one
289
+ framing offset (as per arrays) for each non-fixed-sized item in
290
+ the tuple, except for the last one. Additionally, extra padding
291
+ bytes are added as required for alignment of child values.
292
+ </p>
293
+ <p>
294
+ Variants use the same amount of space as the item inside of the
295
+ variant, plus 1 byte, plus the length of the type string for the
296
+ item inside the variant.
297
+ </p>
298
+ <p>
299
+ As an example, consider a dictionary mapping strings to variants.
300
+ In the case that the dictionary is empty, 0 bytes are required for
301
+ the serialisation.
302
+ </p>
303
+ <p>
304
+ If we add an item "width" that maps to the int32 value of 500 then
305
+ we will use 4 byte to store the int32 (so 6 for the variant
306
+ containing it) and 6 bytes for the string. The variant must be
307
+ aligned to 8 after the 6 bytes of the string, so that's 2 extra
308
+ bytes. 6 (string) + 2 (padding) + 6 (variant) is 14 bytes used
309
+ for the dictionary entry. An additional 1 byte is added to the
310
+ array as a framing offset making a total of 15 bytes.
311
+ </p>
312
+ <p>
313
+ If we add another entry, "title" that maps to a nullable string
314
+ that happens to have a value of null, then we use 0 bytes for the
315
+ null value (and 3 bytes for the variant to contain it along with
316
+ its type string) plus 6 bytes for the string. Again, we need 2
317
+ padding bytes. That makes a total of 6 + 2 + 3 = 11 bytes.
318
+ </p>
319
+ <p>
320
+ We now require extra padding between the two items in the array.
321
+ After the 14 bytes of the first item, that's 2 bytes required. We
322
+ now require 2 framing offsets for an extra two bytes. 14 + 2 + 11
323
+ + 2 = 29 bytes to encode the entire two-item dictionary.
324
+ </p>
325
+ </div>
326
+ <div class="refsect3" title="Type Information Cache">
327
+ <a name="id921363"></a><h4>Type Information Cache</h4>
328
+ <p>
329
+ For each GVariant type that currently exists in the program a type
330
+ information structure is kept in the type information cache. The
331
+ type information structure is required for rapid deserialisation.
332
+ </p>
333
+ <p>
334
+ Continuing with the above example, if a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> exists with the
335
+ type "a{sv}" then a type information struct will exist for
336
+ "a{sv}", "{sv}", "s", and "v". Multiple uses of the same type
337
+ will share the same type information. Additionally, all
338
+ single-digit types are stored in read-only static memory and do
339
+ not contribute to the writable memory footprint of a program using
340
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>.
341
+ </p>
342
+ <p>
343
+ Aside from the type information structures stored in read-only
344
+ memory, there are two forms of type information. One is used for
345
+ container types where there is a single element type: arrays and
346
+ maybe types. The other is used for container types where there
347
+ are multiple element types: tuples and dictionary entries.
348
+ </p>
349
+ <p>
350
+ Array type info structures are 6 * sizeof (void *), plus the
351
+ memory required to store the type string itself. This means that
352
+ on 32bit systems, the cache entry for "a{sv}" would require 30
353
+ bytes of memory (plus malloc overhead).
354
+ </p>
355
+ <p>
356
+ Tuple type info structures are 6 * sizeof (void *), plus 4 *
357
+ sizeof (void *) for each item in the tuple, plus the memory
358
+ required to store the type string itself. A 2-item tuple, for
359
+ example, would have a type information structure that consumed
360
+ writable memory in the size of 14 * sizeof (void *) (plus type
361
+ string) This means that on 32bit systems, the cache entry for
362
+ "{sv}" would require 61 bytes of memory (plus malloc overhead).
363
+ </p>
364
+ <p>
365
+ This means that in total, for our "a{sv}" example, 91 bytes of
366
+ type information would be allocated.
367
+ </p>
368
+ <p>
369
+ The type information cache, additionally, uses a <a class="link" href="glib-Hash-Tables.html#GHashTable" title="GHashTable"><span class="type">GHashTable</span></a> to
370
+ store and lookup the cached items and stores a pointer to this
371
+ hash table in static storage. The hash table is freed when there
372
+ are zero items in the type cache.
373
+ </p>
374
+ <p>
375
+ Although these sizes may seem large it is important to remember
376
+ that a program will probably only have a very small number of
377
+ different types of values in it and that only one type information
378
+ structure is required for many different values of the same type.
379
+ </p>
380
+ </div>
381
+ <div class="refsect3" title="Buffer Management Memory">
382
+ <a name="id921433"></a><h4>Buffer Management Memory</h4>
383
+ <p>
384
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> uses an internal buffer management structure to deal
385
+ with the various different possible sources of serialised data
386
+ that it uses. The buffer is responsible for ensuring that the
387
+ correct call is made when the data is no longer in use by
388
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>. This may involve a <a class="link" href="glib-Memory-Allocation.html#g-free" title="g_free ()"><code class="function">g_free()</code></a> or a <a class="link" href="glib-Memory-Slices.html#g-slice-free" title="g_slice_free()"><code class="function">g_slice_free()</code></a> or
389
+ even <a class="link" href="glib-File-Utilities.html#g-mapped-file-unref" title="g_mapped_file_unref ()"><code class="function">g_mapped_file_unref()</code></a>.
390
+ </p>
391
+ <p>
392
+ One buffer management structure is used for each chunk of
393
+ serialised data. The size of the buffer management structure is 4
394
+ * (void *). On 32bit systems, that's 16 bytes.
395
+ </p>
396
+ </div>
397
+ <div class="refsect3" title="GVariant structure">
398
+ <a name="id921487"></a><h4>GVariant structure</h4>
399
+ <p>
400
+ The size of a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> structure is 6 * (void *). On 32 bit
401
+ systems, that's 24 bytes.
402
+ </p>
403
+ <p>
404
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> structures only exist if they are explicitly created
405
+ with API calls. For example, if a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> is constructed out of
406
+ serialised data for the example given above (with the dictionary)
407
+ then although there are 9 individual values that comprise the
408
+ entire dictionary (two keys, two values, two variants containing
409
+ the values, two dictionary entries, plus the dictionary itself),
410
+ only 1 <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance exists -- the one refering to the
411
+ dictionary.
412
+ </p>
413
+ <p>
414
+ If calls are made to start accessing the other values then
415
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instances will exist for those values only for as long
416
+ as they are in use (ie: until you call <a class="link" href="glib-GVariant.html#g-variant-unref" title="g_variant_unref ()"><code class="function">g_variant_unref()</code></a>). The
417
+ type information is shared. The serialised data and the buffer
418
+ management structure for that serialised data is shared by the
419
+ child.
420
+ </p>
421
+ </div>
422
+ <div class="refsect3" title="Summary">
423
+ <a name="id921548"></a><h4>Summary</h4>
424
+ <p>
425
+ To put the entire example together, for our dictionary mapping
426
+ strings to variants (with two entries, as given above), we are
427
+ using 91 bytes of memory for type information, 29 byes of memory
428
+ for the serialised data, 16 bytes for buffer management and 24
429
+ bytes for the <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance, or a total of 160 bytes, plus
430
+ malloc overhead. If we were to use <a class="link" href="glib-GVariant.html#g-variant-get-child-value" title="g_variant_get_child_value ()"><code class="function">g_variant_get_child_value()</code></a> to
431
+ access the two dictionary entries, we would use an additional 48
432
+ bytes. If we were to have other dictionaries of the same type, we
433
+ would use more memory for the serialised data and buffer
434
+ management for those dictionaries, but the type information would
435
+ be shared.
436
+ </p>
437
+ </div>
438
+ </div>
439
+ </div>
440
+ <div class="refsect1" title="Details">
441
+ <a name="glib-GVariant.details"></a><h2>Details</h2>
442
+ <div class="refsect2" title="GVariant">
443
+ <a name="GVariant"></a><h3>GVariant</h3>
444
+ <pre class="programlisting">typedef struct _GVariant GVariant;</pre>
445
+ <p>
446
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> is an opaque data structure and can only be accessed
447
+ using the following functions.
448
+ </p>
449
+ <p class="since">Since 2.24</p>
450
+ </div>
451
+ <hr>
452
+ <div class="refsect2" title="g_variant_unref ()">
453
+ <a name="g-variant-unref"></a><h3>g_variant_unref ()</h3>
454
+ <pre class="programlisting"><span class="returnvalue">void</span> g_variant_unref (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);</pre>
455
+ <p>
456
+ Decreases the reference count of <em class="parameter"><code>value</code></em>. When its reference count
457
+ drops to 0, the memory used by the variant is freed.
458
+ </p>
459
+ <div class="variablelist"><table border="0">
460
+ <col align="left" valign="top">
461
+ <tbody><tr>
462
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
463
+ <td>a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>
464
+ </td>
465
+ </tr></tbody>
466
+ </table></div>
467
+ <p class="since">Since 2.24</p>
468
+ </div>
469
+ <hr>
470
+ <div class="refsect2" title="g_variant_ref ()">
471
+ <a name="g-variant-ref"></a><h3>g_variant_ref ()</h3>
472
+ <pre class="programlisting"><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * g_variant_ref (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);</pre>
473
+ <p>
474
+ Increases the reference count of <em class="parameter"><code>value</code></em>.
475
+ </p>
476
+ <div class="variablelist"><table border="0">
477
+ <col align="left" valign="top">
478
+ <tbody>
479
+ <tr>
480
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
481
+ <td>a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>
482
+ </td>
483
+ </tr>
484
+ <tr>
485
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
486
+ <td>the same <em class="parameter"><code>value</code></em>
487
+ </td>
488
+ </tr>
489
+ </tbody>
490
+ </table></div>
491
+ <p class="since">Since 2.24</p>
492
+ </div>
493
+ <hr>
494
+ <div class="refsect2" title="g_variant_ref_sink ()">
495
+ <a name="g-variant-ref-sink"></a><h3>g_variant_ref_sink ()</h3>
496
+ <pre class="programlisting"><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * g_variant_ref_sink (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);</pre>
497
+ <p>
498
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> uses a floating reference count system. All functions with
499
+ names starting with <code class="literal">g_variant_new_</code> return floating
500
+ references.
501
+ </p>
502
+ <p>
503
+ Calling <a class="link" href="glib-GVariant.html#g-variant-ref-sink" title="g_variant_ref_sink ()"><code class="function">g_variant_ref_sink()</code></a> on a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> with a floating reference
504
+ will convert the floating reference into a full reference. Calling
505
+ <a class="link" href="glib-GVariant.html#g-variant-ref-sink" title="g_variant_ref_sink ()"><code class="function">g_variant_ref_sink()</code></a> on a non-floating <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> results in an
506
+ additional normal reference being added.
507
+ </p>
508
+ <p>
509
+ In other words, if the <em class="parameter"><code>value</code></em> is floating, then this call "assumes
510
+ ownership" of the floating reference, converting it to a normal
511
+ reference. If the <em class="parameter"><code>value</code></em> is not floating, then this call adds a
512
+ new normal reference increasing the reference count by one.
513
+ </p>
514
+ <p>
515
+ All calls that result in a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance being inserted into a
516
+ container will call <a class="link" href="glib-GVariant.html#g-variant-ref-sink" title="g_variant_ref_sink ()"><code class="function">g_variant_ref_sink()</code></a> on the instance. This means
517
+ that if the value was just created (and has only its floating
518
+ reference) then the container will assume sole ownership of the value
519
+ at that point and the caller will not need to unreference it. This
520
+ makes certain common styles of programming much easier while still
521
+ maintaining normal refcounting semantics in situations where values
522
+ are not floating.
523
+ </p>
524
+ <div class="variablelist"><table border="0">
525
+ <col align="left" valign="top">
526
+ <tbody>
527
+ <tr>
528
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
529
+ <td>a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>
530
+ </td>
531
+ </tr>
532
+ <tr>
533
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
534
+ <td>the same <em class="parameter"><code>value</code></em>
535
+ </td>
536
+ </tr>
537
+ </tbody>
538
+ </table></div>
539
+ <p class="since">Since 2.24</p>
540
+ </div>
541
+ <hr>
542
+ <div class="refsect2" title="g_variant_get_type ()">
543
+ <a name="g-variant-get-type"></a><h3>g_variant_get_type ()</h3>
544
+ <pre class="programlisting">const <a class="link" href="glib-GVariantType.html#GVariantType" title="GVariantType"><span class="returnvalue">GVariantType</span></a> * g_variant_get_type (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);</pre>
545
+ <p>
546
+ Determines the type of <em class="parameter"><code>value</code></em>.
547
+ </p>
548
+ <p>
549
+ The return value is valid for the lifetime of <em class="parameter"><code>value</code></em> and must not
550
+ be freed.
551
+ </p>
552
+ <div class="variablelist"><table border="0">
553
+ <col align="left" valign="top">
554
+ <tbody>
555
+ <tr>
556
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
557
+ <td>a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>
558
+ </td>
559
+ </tr>
560
+ <tr>
561
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
562
+ <td>a <a class="link" href="glib-GVariantType.html#GVariantType" title="GVariantType"><span class="type">GVariantType</span></a>
563
+ </td>
564
+ </tr>
565
+ </tbody>
566
+ </table></div>
567
+ <p class="since">Since 2.24</p>
568
+ </div>
569
+ <hr>
570
+ <div class="refsect2" title="g_variant_get_type_string ()">
571
+ <a name="g-variant-get-type-string"></a><h3>g_variant_get_type_string ()</h3>
572
+ <pre class="programlisting">const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_variant_get_type_string (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);</pre>
573
+ <p>
574
+ Returns the type string of <em class="parameter"><code>value</code></em>. Unlike the result of calling
575
+ <a class="link" href="glib-GVariantType.html#g-variant-type-peek-string" title="g_variant_type_peek_string ()"><code class="function">g_variant_type_peek_string()</code></a>, this string is nul-terminated. This
576
+ string belongs to <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> and must not be freed.
577
+ </p>
578
+ <div class="variablelist"><table border="0">
579
+ <col align="left" valign="top">
580
+ <tbody>
581
+ <tr>
582
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
583
+ <td>a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>
584
+ </td>
585
+ </tr>
586
+ <tr>
587
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
588
+ <td>the type string for the type of <em class="parameter"><code>value</code></em>
589
+ </td>
590
+ </tr>
591
+ </tbody>
592
+ </table></div>
593
+ <p class="since">Since 2.24</p>
594
+ </div>
595
+ <hr>
596
+ <div class="refsect2" title="g_variant_is_of_type ()">
597
+ <a name="g-variant-is-of-type"></a><h3>g_variant_is_of_type ()</h3>
598
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_variant_is_of_type (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>,
599
+ <em class="parameter"><code>const <a class="link" href="glib-GVariantType.html#GVariantType" title="GVariantType"><span class="type">GVariantType</span></a> *type</code></em>);</pre>
600
+ <p>
601
+ Checks if a value has a type matching the provided type.
602
+ </p>
603
+ <div class="variablelist"><table border="0">
604
+ <col align="left" valign="top">
605
+ <tbody>
606
+ <tr>
607
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
608
+ <td>a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance
609
+ </td>
610
+ </tr>
611
+ <tr>
612
+ <td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
613
+ <td>a <a class="link" href="glib-GVariantType.html#GVariantType" title="GVariantType"><span class="type">GVariantType</span></a>
614
+ </td>
615
+ </tr>
616
+ <tr>
617
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
618
+ <td>
619
+ <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the type of <em class="parameter"><code>value</code></em> matches <em class="parameter"><code>type</code></em>
620
+ </td>
621
+ </tr>
622
+ </tbody>
623
+ </table></div>
624
+ <p class="since">Since 2.24</p>
625
+ </div>
626
+ <hr>
627
+ <div class="refsect2" title="g_variant_is_container ()">
628
+ <a name="g-variant-is-container"></a><h3>g_variant_is_container ()</h3>
629
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_variant_is_container (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);</pre>
630
+ <p>
631
+ Checks if <em class="parameter"><code>value</code></em> is a container.
632
+ </p>
633
+ <div class="variablelist"><table border="0">
634
+ <col align="left" valign="top">
635
+ <tbody>
636
+ <tr>
637
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
638
+ <td>a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance
639
+ </td>
640
+ </tr>
641
+ <tr>
642
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
643
+ <td>
644
+ <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if <em class="parameter"><code>value</code></em> is a container
645
+ </td>
646
+ </tr>
647
+ </tbody>
648
+ </table></div>
649
+ </div>
650
+ <hr>
651
+ <div class="refsect2" title="g_variant_classify ()">
652
+ <a name="g-variant-classify"></a><h3>g_variant_classify ()</h3>
653
+ <pre class="programlisting"><a class="link" href="glib-GVariant.html#GVariantClass" title="enum GVariantClass"><span class="returnvalue">GVariantClass</span></a> g_variant_classify (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);</pre>
654
+ <p>
655
+ Classifies <em class="parameter"><code>value</code></em> according to its top-level type.
656
+ </p>
657
+ <div class="variablelist"><table border="0">
658
+ <col align="left" valign="top">
659
+ <tbody>
660
+ <tr>
661
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
662
+ <td>a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>
663
+ </td>
664
+ </tr>
665
+ <tr>
666
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
667
+ <td>the <a class="link" href="glib-GVariant.html#GVariantClass" title="enum GVariantClass"><span class="type">GVariantClass</span></a> of <em class="parameter"><code>value</code></em>
668
+ </td>
669
+ </tr>
670
+ </tbody>
671
+ </table></div>
672
+ <p class="since">Since 2.24</p>
673
+ </div>
674
+ <hr>
675
+ <div class="refsect2" title="enum GVariantClass">
676
+ <a name="GVariantClass"></a><h3>enum GVariantClass</h3>
677
+ <pre class="programlisting">typedef enum
678
+ {
679
+ G_VARIANT_CLASS_BOOLEAN = 'b',
680
+ G_VARIANT_CLASS_BYTE = 'y',
681
+ G_VARIANT_CLASS_INT16 = 'n',
682
+ G_VARIANT_CLASS_UINT16 = 'q',
683
+ G_VARIANT_CLASS_INT32 = 'i',
684
+ G_VARIANT_CLASS_UINT32 = 'u',
685
+ G_VARIANT_CLASS_INT64 = 'x',
686
+ G_VARIANT_CLASS_UINT64 = 't',
687
+ G_VARIANT_CLASS_HANDLE = 'h',
688
+ G_VARIANT_CLASS_DOUBLE = 'd',
689
+ G_VARIANT_CLASS_STRING = 's',
690
+ G_VARIANT_CLASS_OBJECT_PATH = 'o',
691
+ G_VARIANT_CLASS_SIGNATURE = 'g',
692
+ G_VARIANT_CLASS_VARIANT = 'v',
693
+ G_VARIANT_CLASS_MAYBE = 'm',
694
+ G_VARIANT_CLASS_ARRAY = 'a',
695
+ G_VARIANT_CLASS_TUPLE = '(',
696
+ G_VARIANT_CLASS_DICT_ENTRY = '{'
697
+ } GVariantClass;
698
+ </pre>
699
+ <p>
700
+ The range of possible top-level types of <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instances.
701
+ </p>
702
+ <div class="variablelist"><table border="0">
703
+ <col align="left" valign="top">
704
+ <tbody>
705
+ <tr>
706
+ <td><p><a name="G-VARIANT-CLASS-BOOLEAN:CAPS"></a><span class="term"><code class="literal">G_VARIANT_CLASS_BOOLEAN</code></span></p></td>
707
+ <td>The <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> is a boolean.
708
+ </td>
709
+ </tr>
710
+ <tr>
711
+ <td><p><a name="G-VARIANT-CLASS-BYTE:CAPS"></a><span class="term"><code class="literal">G_VARIANT_CLASS_BYTE</code></span></p></td>
712
+ <td>The <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> is a byte.
713
+ </td>
714
+ </tr>
715
+ <tr>
716
+ <td><p><a name="G-VARIANT-CLASS-INT16:CAPS"></a><span class="term"><code class="literal">G_VARIANT_CLASS_INT16</code></span></p></td>
717
+ <td>The <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> is a signed 16 bit integer.
718
+ </td>
719
+ </tr>
720
+ <tr>
721
+ <td><p><a name="G-VARIANT-CLASS-UINT16:CAPS"></a><span class="term"><code class="literal">G_VARIANT_CLASS_UINT16</code></span></p></td>
722
+ <td>The <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> is an unsigned 16 bit integer.
723
+ </td>
724
+ </tr>
725
+ <tr>
726
+ <td><p><a name="G-VARIANT-CLASS-INT32:CAPS"></a><span class="term"><code class="literal">G_VARIANT_CLASS_INT32</code></span></p></td>
727
+ <td>The <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> is a signed 32 bit integer.
728
+ </td>
729
+ </tr>
730
+ <tr>
731
+ <td><p><a name="G-VARIANT-CLASS-UINT32:CAPS"></a><span class="term"><code class="literal">G_VARIANT_CLASS_UINT32</code></span></p></td>
732
+ <td>The <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> is an unsigned 32 bit integer.
733
+ </td>
734
+ </tr>
735
+ <tr>
736
+ <td><p><a name="G-VARIANT-CLASS-INT64:CAPS"></a><span class="term"><code class="literal">G_VARIANT_CLASS_INT64</code></span></p></td>
737
+ <td>The <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> is a signed 64 bit integer.
738
+ </td>
739
+ </tr>
740
+ <tr>
741
+ <td><p><a name="G-VARIANT-CLASS-UINT64:CAPS"></a><span class="term"><code class="literal">G_VARIANT_CLASS_UINT64</code></span></p></td>
742
+ <td>The <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> is an unsigned 64 bit integer.
743
+ </td>
744
+ </tr>
745
+ <tr>
746
+ <td><p><a name="G-VARIANT-CLASS-HANDLE:CAPS"></a><span class="term"><code class="literal">G_VARIANT_CLASS_HANDLE</code></span></p></td>
747
+ <td>The <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> is a file handle index.
748
+ </td>
749
+ </tr>
750
+ <tr>
751
+ <td><p><a name="G-VARIANT-CLASS-DOUBLE:CAPS"></a><span class="term"><code class="literal">G_VARIANT_CLASS_DOUBLE</code></span></p></td>
752
+ <td>The <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> is a double precision floating
753
+ point value.
754
+ </td>
755
+ </tr>
756
+ <tr>
757
+ <td><p><a name="G-VARIANT-CLASS-STRING:CAPS"></a><span class="term"><code class="literal">G_VARIANT_CLASS_STRING</code></span></p></td>
758
+ <td>The <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> is a normal string.
759
+ </td>
760
+ </tr>
761
+ <tr>
762
+ <td><p><a name="G-VARIANT-CLASS-OBJECT-PATH:CAPS"></a><span class="term"><code class="literal">G_VARIANT_CLASS_OBJECT_PATH</code></span></p></td>
763
+ <td>The <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> is a DBus object path
764
+ string.
765
+ </td>
766
+ </tr>
767
+ <tr>
768
+ <td><p><a name="G-VARIANT-CLASS-SIGNATURE:CAPS"></a><span class="term"><code class="literal">G_VARIANT_CLASS_SIGNATURE</code></span></p></td>
769
+ <td>The <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> is a DBus signature string.
770
+ </td>
771
+ </tr>
772
+ <tr>
773
+ <td><p><a name="G-VARIANT-CLASS-VARIANT:CAPS"></a><span class="term"><code class="literal">G_VARIANT_CLASS_VARIANT</code></span></p></td>
774
+ <td>The <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> is a variant.
775
+ </td>
776
+ </tr>
777
+ <tr>
778
+ <td><p><a name="G-VARIANT-CLASS-MAYBE:CAPS"></a><span class="term"><code class="literal">G_VARIANT_CLASS_MAYBE</code></span></p></td>
779
+ <td>The <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> is a maybe-typed value.
780
+ </td>
781
+ </tr>
782
+ <tr>
783
+ <td><p><a name="G-VARIANT-CLASS-ARRAY:CAPS"></a><span class="term"><code class="literal">G_VARIANT_CLASS_ARRAY</code></span></p></td>
784
+ <td>The <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> is an array.
785
+ </td>
786
+ </tr>
787
+ <tr>
788
+ <td><p><a name="G-VARIANT-CLASS-TUPLE:CAPS"></a><span class="term"><code class="literal">G_VARIANT_CLASS_TUPLE</code></span></p></td>
789
+ <td>The <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> is a tuple.
790
+ </td>
791
+ </tr>
792
+ <tr>
793
+ <td><p><a name="G-VARIANT-CLASS-DICT-ENTRY:CAPS"></a><span class="term"><code class="literal">G_VARIANT_CLASS_DICT_ENTRY</code></span></p></td>
794
+ <td>The <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> is a dictionary entry.
795
+ </td>
796
+ </tr>
797
+ </tbody>
798
+ </table></div>
799
+ <p class="since">Since 2.24</p>
800
+ </div>
801
+ <hr>
802
+ <div class="refsect2" title="g_variant_get ()">
803
+ <a name="g-variant-get"></a><h3>g_variant_get ()</h3>
804
+ <pre class="programlisting"><span class="returnvalue">void</span> g_variant_get (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>,
805
+ <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *format_string</code></em>,
806
+ <em class="parameter"><code>...</code></em>);</pre>
807
+ <p>
808
+ Deconstructs a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance.
809
+ </p>
810
+ <p>
811
+ Think of this function as an analogue to <code class="function">scanf()</code>.
812
+ </p>
813
+ <p>
814
+ The arguments that are expected by this function are entirely
815
+ determined by <em class="parameter"><code>format_string</code></em>. <em class="parameter"><code>format_string</code></em> also restricts the
816
+ permissible types of <em class="parameter"><code>value</code></em>. It is an error to give a value with
817
+ an incompatible type. See the section on <a href="gvariant-format-strings.html">GVariant Format Strings</a>.
818
+ Please note that the syntax of the format string is very likely to be
819
+ extended in the future.
820
+ </p>
821
+ <div class="variablelist"><table border="0">
822
+ <col align="left" valign="top">
823
+ <tbody>
824
+ <tr>
825
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
826
+ <td>a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance
827
+ </td>
828
+ </tr>
829
+ <tr>
830
+ <td><p><span class="term"><em class="parameter"><code>format_string</code></em> :</span></p></td>
831
+ <td>a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> format string
832
+ </td>
833
+ </tr>
834
+ <tr>
835
+ <td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
836
+ <td>arguments, as per <em class="parameter"><code>format_string</code></em>
837
+ </td>
838
+ </tr>
839
+ </tbody>
840
+ </table></div>
841
+ <p class="since">Since 2.24</p>
842
+ </div>
843
+ <hr>
844
+ <div class="refsect2" title="g_variant_get_va ()">
845
+ <a name="g-variant-get-va"></a><h3>g_variant_get_va ()</h3>
846
+ <pre class="programlisting"><span class="returnvalue">void</span> g_variant_get_va (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>,
847
+ <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *format_string</code></em>,
848
+ <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **endptr</code></em>,
849
+ <em class="parameter"><code><span class="type">va_list</span> *app</code></em>);</pre>
850
+ <p>
851
+ This function is intended to be used by libraries based on <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>
852
+ that want to provide <a class="link" href="glib-GVariant.html#g-variant-get" title="g_variant_get ()"><code class="function">g_variant_get()</code></a>-like functionality to their
853
+ users.
854
+ </p>
855
+ <p>
856
+ The API is more general than <a class="link" href="glib-GVariant.html#g-variant-get" title="g_variant_get ()"><code class="function">g_variant_get()</code></a> to allow a wider range
857
+ of possible uses.
858
+ </p>
859
+ <p>
860
+ <em class="parameter"><code>format_string</code></em> must still point to a valid format string, but it only
861
+ need to be nul-terminated if <em class="parameter"><code>endptr</code></em> is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. If <em class="parameter"><code>endptr</code></em> is
862
+ non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> then it is updated to point to the first character past the
863
+ end of the format string.
864
+ </p>
865
+ <p>
866
+ <em class="parameter"><code>app</code></em> is a pointer to a <span class="type">va_list</span>. The arguments, according to
867
+ <em class="parameter"><code>format_string</code></em>, are collected from this <span class="type">va_list</span> and the list is left
868
+ pointing to the argument following the last.
869
+ </p>
870
+ <p>
871
+ These two generalisations allow mixing of multiple calls to
872
+ <a class="link" href="glib-GVariant.html#g-variant-new-va" title="g_variant_new_va ()"><code class="function">g_variant_new_va()</code></a> and <a class="link" href="glib-GVariant.html#g-variant-get-va" title="g_variant_get_va ()"><code class="function">g_variant_get_va()</code></a> within a single actual
873
+ varargs call by the user.
874
+ </p>
875
+ <div class="variablelist"><table border="0">
876
+ <col align="left" valign="top">
877
+ <tbody>
878
+ <tr>
879
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
880
+ <td>a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>
881
+ </td>
882
+ </tr>
883
+ <tr>
884
+ <td><p><span class="term"><em class="parameter"><code>format_string</code></em> :</span></p></td>
885
+ <td>a string that is prefixed with a format string
886
+ </td>
887
+ </tr>
888
+ <tr>
889
+ <td><p><span class="term"><em class="parameter"><code>endptr</code></em> :</span></p></td>
890
+ <td>location to store the end pointer, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
891
+ </td>
892
+ </tr>
893
+ <tr>
894
+ <td><p><span class="term"><em class="parameter"><code>app</code></em> :</span></p></td>
895
+ <td>a pointer to a <span class="type">va_list</span>
896
+ </td>
897
+ </tr>
898
+ </tbody>
899
+ </table></div>
900
+ <p class="since">Since 2.24</p>
901
+ </div>
902
+ <hr>
903
+ <div class="refsect2" title="g_variant_new ()">
904
+ <a name="g-variant-new"></a><h3>g_variant_new ()</h3>
905
+ <pre class="programlisting"><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * g_variant_new (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *format_string</code></em>,
906
+ <em class="parameter"><code>...</code></em>);</pre>
907
+ <p>
908
+ Creates a new <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance.
909
+ </p>
910
+ <p>
911
+ Think of this function as an analogue to <a class="link" href="glib-String-Utility-Functions.html#g-strdup-printf" title="g_strdup_printf ()"><code class="function">g_strdup_printf()</code></a>.
912
+ </p>
913
+ <p>
914
+ The type of the created instance and the arguments that are
915
+ expected by this function are determined by <em class="parameter"><code>format_string</code></em>. See the
916
+ section on <GTKDOCLINK HREF="gvariant-format-strings">GVariant Format
917
+ Strings</GTKDOCLINK>. Please note that the syntax of the format string is
918
+ very likely to be extended in the future.
919
+ </p>
920
+ <p>
921
+ The first character of the format string must not be '*' '?' '@' or
922
+ 'r'; in essence, a new <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> must always be constructed by this
923
+ function (and not merely passed through it unmodified).
924
+ </p>
925
+ <div class="variablelist"><table border="0">
926
+ <col align="left" valign="top">
927
+ <tbody>
928
+ <tr>
929
+ <td><p><span class="term"><em class="parameter"><code>format_string</code></em> :</span></p></td>
930
+ <td>a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> format string
931
+ </td>
932
+ </tr>
933
+ <tr>
934
+ <td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
935
+ <td>arguments, as per <em class="parameter"><code>format_string</code></em>
936
+ </td>
937
+ </tr>
938
+ <tr>
939
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
940
+ <td>a new floating <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance
941
+ </td>
942
+ </tr>
943
+ </tbody>
944
+ </table></div>
945
+ <p class="since">Since 2.24</p>
946
+ </div>
947
+ <hr>
948
+ <div class="refsect2" title="g_variant_new_va ()">
949
+ <a name="g-variant-new-va"></a><h3>g_variant_new_va ()</h3>
950
+ <pre class="programlisting"><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * g_variant_new_va (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *format_string</code></em>,
951
+ <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **endptr</code></em>,
952
+ <em class="parameter"><code><span class="type">va_list</span> *app</code></em>);</pre>
953
+ <p>
954
+ This function is intended to be used by libraries based on
955
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> that want to provide <a class="link" href="glib-GVariant.html#g-variant-new" title="g_variant_new ()"><code class="function">g_variant_new()</code></a>-like functionality
956
+ to their users.
957
+ </p>
958
+ <p>
959
+ The API is more general than <a class="link" href="glib-GVariant.html#g-variant-new" title="g_variant_new ()"><code class="function">g_variant_new()</code></a> to allow a wider range
960
+ of possible uses.
961
+ </p>
962
+ <p>
963
+ <em class="parameter"><code>format_string</code></em> must still point to a valid format string, but it only
964
+ needs to be nul-terminated if <em class="parameter"><code>endptr</code></em> is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. If <em class="parameter"><code>endptr</code></em> is
965
+ non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> then it is updated to point to the first character past the
966
+ end of the format string.
967
+ </p>
968
+ <p>
969
+ <em class="parameter"><code>app</code></em> is a pointer to a <span class="type">va_list</span>. The arguments, according to
970
+ <em class="parameter"><code>format_string</code></em>, are collected from this <span class="type">va_list</span> and the list is left
971
+ pointing to the argument following the last.
972
+ </p>
973
+ <p>
974
+ These two generalisations allow mixing of multiple calls to
975
+ <a class="link" href="glib-GVariant.html#g-variant-new-va" title="g_variant_new_va ()"><code class="function">g_variant_new_va()</code></a> and <a class="link" href="glib-GVariant.html#g-variant-get-va" title="g_variant_get_va ()"><code class="function">g_variant_get_va()</code></a> within a single actual
976
+ varargs call by the user.
977
+ </p>
978
+ <p>
979
+ The return value will be floating if it was a newly created GVariant
980
+ instance (for example, if the format string was "(ii)"). In the case
981
+ that the format_string was '*', '?', 'r', or a format starting with
982
+ '@' then the collected <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> pointer will be returned unmodified,
983
+ without adding any additional references.
984
+ </p>
985
+ <p>
986
+ In order to behave correctly in all cases it is necessary for the
987
+ calling function to <a class="link" href="glib-GVariant.html#g-variant-ref-sink" title="g_variant_ref_sink ()"><code class="function">g_variant_ref_sink()</code></a> the return result before
988
+ returning control to the user that originally provided the pointer.
989
+ At this point, the caller will have their own full reference to the
990
+ result. This can also be done by adding the result to a container,
991
+ or by passing it to another <a class="link" href="glib-GVariant.html#g-variant-new" title="g_variant_new ()"><code class="function">g_variant_new()</code></a> call.
992
+ </p>
993
+ <div class="variablelist"><table border="0">
994
+ <col align="left" valign="top">
995
+ <tbody>
996
+ <tr>
997
+ <td><p><span class="term"><em class="parameter"><code>format_string</code></em> :</span></p></td>
998
+ <td>a string that is prefixed with a format string
999
+ </td>
1000
+ </tr>
1001
+ <tr>
1002
+ <td><p><span class="term"><em class="parameter"><code>endptr</code></em> :</span></p></td>
1003
+ <td>location to store the end pointer, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
1004
+ </td>
1005
+ </tr>
1006
+ <tr>
1007
+ <td><p><span class="term"><em class="parameter"><code>app</code></em> :</span></p></td>
1008
+ <td>a pointer to a <span class="type">va_list</span>
1009
+ </td>
1010
+ </tr>
1011
+ <tr>
1012
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1013
+ <td>a new, usually floating, <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>
1014
+ </td>
1015
+ </tr>
1016
+ </tbody>
1017
+ </table></div>
1018
+ <p class="since">Since 2.24</p>
1019
+ </div>
1020
+ <hr>
1021
+ <div class="refsect2" title="g_variant_new_boolean ()">
1022
+ <a name="g-variant-new-boolean"></a><h3>g_variant_new_boolean ()</h3>
1023
+ <pre class="programlisting"><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * g_variant_new_boolean (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="type">gboolean</span></a> boolean</code></em>);</pre>
1024
+ <p>
1025
+ Creates a new boolean <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance -- either <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> or <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a>.
1026
+ </p>
1027
+ <div class="variablelist"><table border="0">
1028
+ <col align="left" valign="top">
1029
+ <tbody>
1030
+ <tr>
1031
+ <td><p><span class="term"><em class="parameter"><code>boolean</code></em> :</span></p></td>
1032
+ <td>a <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="type">gboolean</span></a> value
1033
+ </td>
1034
+ </tr>
1035
+ <tr>
1036
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1037
+ <td>a new boolean <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance
1038
+ </td>
1039
+ </tr>
1040
+ </tbody>
1041
+ </table></div>
1042
+ <p class="since">Since 2.24</p>
1043
+ </div>
1044
+ <hr>
1045
+ <div class="refsect2" title="g_variant_new_byte ()">
1046
+ <a name="g-variant-new-byte"></a><h3>g_variant_new_byte ()</h3>
1047
+ <pre class="programlisting"><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * g_variant_new_byte (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guchar" title="guchar"><span class="type">guchar</span></a> byte</code></em>);</pre>
1048
+ <p>
1049
+ Creates a new byte <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance.
1050
+ </p>
1051
+ <div class="variablelist"><table border="0">
1052
+ <col align="left" valign="top">
1053
+ <tbody>
1054
+ <tr>
1055
+ <td><p><span class="term"><em class="parameter"><code>byte</code></em> :</span></p></td>
1056
+ <td>a <a class="link" href="glib-Basic-Types.html#guint8" title="guint8"><span class="type">guint8</span></a> value
1057
+ </td>
1058
+ </tr>
1059
+ <tr>
1060
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1061
+ <td>a new byte <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance
1062
+ </td>
1063
+ </tr>
1064
+ </tbody>
1065
+ </table></div>
1066
+ <p class="since">Since 2.24</p>
1067
+ </div>
1068
+ <hr>
1069
+ <div class="refsect2" title="g_variant_new_int16 ()">
1070
+ <a name="g-variant-new-int16"></a><h3>g_variant_new_int16 ()</h3>
1071
+ <pre class="programlisting"><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * g_variant_new_int16 (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint16" title="gint16"><span class="type">gint16</span></a> int16</code></em>);</pre>
1072
+ <p>
1073
+ Creates a new int16 <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance.
1074
+ </p>
1075
+ <div class="variablelist"><table border="0">
1076
+ <col align="left" valign="top">
1077
+ <tbody>
1078
+ <tr>
1079
+ <td><p><span class="term"><em class="parameter"><code>int16</code></em> :</span></p></td>
1080
+ <td>a <a class="link" href="glib-Basic-Types.html#gint16" title="gint16"><span class="type">gint16</span></a> value
1081
+ </td>
1082
+ </tr>
1083
+ <tr>
1084
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1085
+ <td>a new int16 <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance
1086
+ </td>
1087
+ </tr>
1088
+ </tbody>
1089
+ </table></div>
1090
+ <p class="since">Since 2.24</p>
1091
+ </div>
1092
+ <hr>
1093
+ <div class="refsect2" title="g_variant_new_uint16 ()">
1094
+ <a name="g-variant-new-uint16"></a><h3>g_variant_new_uint16 ()</h3>
1095
+ <pre class="programlisting"><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * g_variant_new_uint16 (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint16" title="guint16"><span class="type">guint16</span></a> uint16</code></em>);</pre>
1096
+ <p>
1097
+ Creates a new uint16 <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance.
1098
+ </p>
1099
+ <div class="variablelist"><table border="0">
1100
+ <col align="left" valign="top">
1101
+ <tbody>
1102
+ <tr>
1103
+ <td><p><span class="term"><em class="parameter"><code>uint16</code></em> :</span></p></td>
1104
+ <td>a <a class="link" href="glib-Basic-Types.html#guint16" title="guint16"><span class="type">guint16</span></a> value
1105
+ </td>
1106
+ </tr>
1107
+ <tr>
1108
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1109
+ <td>a new uint16 <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance
1110
+ </td>
1111
+ </tr>
1112
+ </tbody>
1113
+ </table></div>
1114
+ <p class="since">Since 2.24</p>
1115
+ </div>
1116
+ <hr>
1117
+ <div class="refsect2" title="g_variant_new_int32 ()">
1118
+ <a name="g-variant-new-int32"></a><h3>g_variant_new_int32 ()</h3>
1119
+ <pre class="programlisting"><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * g_variant_new_int32 (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint32" title="gint32"><span class="type">gint32</span></a> int32</code></em>);</pre>
1120
+ <p>
1121
+ Creates a new int32 <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance.
1122
+ </p>
1123
+ <div class="variablelist"><table border="0">
1124
+ <col align="left" valign="top">
1125
+ <tbody>
1126
+ <tr>
1127
+ <td><p><span class="term"><em class="parameter"><code>int32</code></em> :</span></p></td>
1128
+ <td>a <a class="link" href="glib-Basic-Types.html#gint32" title="gint32"><span class="type">gint32</span></a> value
1129
+ </td>
1130
+ </tr>
1131
+ <tr>
1132
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1133
+ <td>a new int32 <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance
1134
+ </td>
1135
+ </tr>
1136
+ </tbody>
1137
+ </table></div>
1138
+ <p class="since">Since 2.24</p>
1139
+ </div>
1140
+ <hr>
1141
+ <div class="refsect2" title="g_variant_new_uint32 ()">
1142
+ <a name="g-variant-new-uint32"></a><h3>g_variant_new_uint32 ()</h3>
1143
+ <pre class="programlisting"><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * g_variant_new_uint32 (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint32" title="guint32"><span class="type">guint32</span></a> uint32</code></em>);</pre>
1144
+ <p>
1145
+ Creates a new uint32 <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance.
1146
+ </p>
1147
+ <div class="variablelist"><table border="0">
1148
+ <col align="left" valign="top">
1149
+ <tbody>
1150
+ <tr>
1151
+ <td><p><span class="term"><em class="parameter"><code>uint32</code></em> :</span></p></td>
1152
+ <td>a <a class="link" href="glib-Basic-Types.html#guint32" title="guint32"><span class="type">guint32</span></a> value
1153
+ </td>
1154
+ </tr>
1155
+ <tr>
1156
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1157
+ <td>a new uint32 <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance
1158
+ </td>
1159
+ </tr>
1160
+ </tbody>
1161
+ </table></div>
1162
+ <p class="since">Since 2.24</p>
1163
+ </div>
1164
+ <hr>
1165
+ <div class="refsect2" title="g_variant_new_int64 ()">
1166
+ <a name="g-variant-new-int64"></a><h3>g_variant_new_int64 ()</h3>
1167
+ <pre class="programlisting"><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * g_variant_new_int64 (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint64" title="gint64"><span class="type">gint64</span></a> int64</code></em>);</pre>
1168
+ <p>
1169
+ Creates a new int64 <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance.
1170
+ </p>
1171
+ <div class="variablelist"><table border="0">
1172
+ <col align="left" valign="top">
1173
+ <tbody>
1174
+ <tr>
1175
+ <td><p><span class="term"><em class="parameter"><code>int64</code></em> :</span></p></td>
1176
+ <td>a <a class="link" href="glib-Basic-Types.html#gint64" title="gint64"><span class="type">gint64</span></a> value
1177
+ </td>
1178
+ </tr>
1179
+ <tr>
1180
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1181
+ <td>a new int64 <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance
1182
+ </td>
1183
+ </tr>
1184
+ </tbody>
1185
+ </table></div>
1186
+ <p class="since">Since 2.24</p>
1187
+ </div>
1188
+ <hr>
1189
+ <div class="refsect2" title="g_variant_new_uint64 ()">
1190
+ <a name="g-variant-new-uint64"></a><h3>g_variant_new_uint64 ()</h3>
1191
+ <pre class="programlisting"><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * g_variant_new_uint64 (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint64" title="guint64"><span class="type">guint64</span></a> uint64</code></em>);</pre>
1192
+ <p>
1193
+ Creates a new uint64 <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance.
1194
+ </p>
1195
+ <div class="variablelist"><table border="0">
1196
+ <col align="left" valign="top">
1197
+ <tbody>
1198
+ <tr>
1199
+ <td><p><span class="term"><em class="parameter"><code>uint64</code></em> :</span></p></td>
1200
+ <td>a <a class="link" href="glib-Basic-Types.html#guint64" title="guint64"><span class="type">guint64</span></a> value
1201
+ </td>
1202
+ </tr>
1203
+ <tr>
1204
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1205
+ <td>a new uint64 <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance
1206
+ </td>
1207
+ </tr>
1208
+ </tbody>
1209
+ </table></div>
1210
+ <p class="since">Since 2.24</p>
1211
+ </div>
1212
+ <hr>
1213
+ <div class="refsect2" title="g_variant_new_handle ()">
1214
+ <a name="g-variant-new-handle"></a><h3>g_variant_new_handle ()</h3>
1215
+ <pre class="programlisting"><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * g_variant_new_handle (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint32" title="gint32"><span class="type">gint32</span></a> handle</code></em>);</pre>
1216
+ <p>
1217
+ Creates a new handle <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance.
1218
+ </p>
1219
+ <p>
1220
+ By convention, handles are indexes into an array of file descriptors
1221
+ that are sent alongside a DBus message. If you're not interacting
1222
+ with DBus, you probably don't need them.
1223
+ </p>
1224
+ <div class="variablelist"><table border="0">
1225
+ <col align="left" valign="top">
1226
+ <tbody>
1227
+ <tr>
1228
+ <td><p><span class="term"><em class="parameter"><code>handle</code></em> :</span></p></td>
1229
+ <td>a <a class="link" href="glib-Basic-Types.html#gint32" title="gint32"><span class="type">gint32</span></a> value
1230
+ </td>
1231
+ </tr>
1232
+ <tr>
1233
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1234
+ <td>a new handle <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance
1235
+ </td>
1236
+ </tr>
1237
+ </tbody>
1238
+ </table></div>
1239
+ <p class="since">Since 2.24</p>
1240
+ </div>
1241
+ <hr>
1242
+ <div class="refsect2" title="g_variant_new_double ()">
1243
+ <a name="g-variant-new-double"></a><h3>g_variant_new_double ()</h3>
1244
+ <pre class="programlisting"><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * g_variant_new_double (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gdouble" title="gdouble"><span class="type">gdouble</span></a> floating</code></em>);</pre>
1245
+ <p>
1246
+ Creates a new double <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance.
1247
+ </p>
1248
+ <div class="variablelist"><table border="0">
1249
+ <col align="left" valign="top">
1250
+ <tbody>
1251
+ <tr>
1252
+ <td><p><span class="term"><em class="parameter"><code>floating</code></em> :</span></p></td>
1253
+ <td>a <a class="link" href="glib-Basic-Types.html#gdouble" title="gdouble"><span class="type">gdouble</span></a> floating point value
1254
+ </td>
1255
+ </tr>
1256
+ <tr>
1257
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1258
+ <td>a new double <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance
1259
+ </td>
1260
+ </tr>
1261
+ </tbody>
1262
+ </table></div>
1263
+ <p class="since">Since 2.24</p>
1264
+ </div>
1265
+ <hr>
1266
+ <div class="refsect2" title="g_variant_new_string ()">
1267
+ <a name="g-variant-new-string"></a><h3>g_variant_new_string ()</h3>
1268
+ <pre class="programlisting"><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * g_variant_new_string (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *string</code></em>);</pre>
1269
+ <p>
1270
+ Creates a string <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> with the contents of <em class="parameter"><code>string</code></em>.
1271
+ </p>
1272
+ <div class="variablelist"><table border="0">
1273
+ <col align="left" valign="top">
1274
+ <tbody>
1275
+ <tr>
1276
+ <td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
1277
+ <td>a normal C nul-terminated string
1278
+ </td>
1279
+ </tr>
1280
+ <tr>
1281
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1282
+ <td>a new string <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance
1283
+ </td>
1284
+ </tr>
1285
+ </tbody>
1286
+ </table></div>
1287
+ <p class="since">Since 2.24</p>
1288
+ </div>
1289
+ <hr>
1290
+ <div class="refsect2" title="g_variant_new_object_path ()">
1291
+ <a name="g-variant-new-object-path"></a><h3>g_variant_new_object_path ()</h3>
1292
+ <pre class="programlisting"><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * g_variant_new_object_path (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *object_path</code></em>);</pre>
1293
+ <p>
1294
+ Creates a DBus object path <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> with the contents of <em class="parameter"><code>string</code></em>.
1295
+ <em class="parameter"><code>string</code></em> must be a valid DBus object path. Use
1296
+ <a class="link" href="glib-GVariant.html#g-variant-is-object-path" title="g_variant_is_object_path ()"><code class="function">g_variant_is_object_path()</code></a> if you're not sure.
1297
+ </p>
1298
+ <div class="variablelist"><table border="0">
1299
+ <col align="left" valign="top">
1300
+ <tbody>
1301
+ <tr>
1302
+ <td><p><span class="term"><em class="parameter"><code>object_path</code></em> :</span></p></td>
1303
+ <td>a normal C nul-terminated string
1304
+ </td>
1305
+ </tr>
1306
+ <tr>
1307
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1308
+ <td>a new object path <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance
1309
+ </td>
1310
+ </tr>
1311
+ </tbody>
1312
+ </table></div>
1313
+ <p class="since">Since 2.24</p>
1314
+ </div>
1315
+ <hr>
1316
+ <div class="refsect2" title="g_variant_is_object_path ()">
1317
+ <a name="g-variant-is-object-path"></a><h3>g_variant_is_object_path ()</h3>
1318
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_variant_is_object_path (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *string</code></em>);</pre>
1319
+ <p>
1320
+ Determines if a given string is a valid DBus object path. You
1321
+ should ensure that a string is a valid DBus object path before
1322
+ passing it to <a class="link" href="glib-GVariant.html#g-variant-new-object-path" title="g_variant_new_object_path ()"><code class="function">g_variant_new_object_path()</code></a>.
1323
+ </p>
1324
+ <p>
1325
+ A valid object path starts with '/' followed by zero or more
1326
+ sequences of characters separated by '/' characters. Each sequence
1327
+ must contain only the characters "[A-Z][a-z][0-9]_". No sequence
1328
+ (including the one following the final '/' character) may be empty.
1329
+ </p>
1330
+ <div class="variablelist"><table border="0">
1331
+ <col align="left" valign="top">
1332
+ <tbody>
1333
+ <tr>
1334
+ <td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
1335
+ <td>a normal C nul-terminated string
1336
+ </td>
1337
+ </tr>
1338
+ <tr>
1339
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1340
+ <td>
1341
+ <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if <em class="parameter"><code>string</code></em> is a DBus object path
1342
+ </td>
1343
+ </tr>
1344
+ </tbody>
1345
+ </table></div>
1346
+ <p class="since">Since 2.24</p>
1347
+ </div>
1348
+ <hr>
1349
+ <div class="refsect2" title="g_variant_new_signature ()">
1350
+ <a name="g-variant-new-signature"></a><h3>g_variant_new_signature ()</h3>
1351
+ <pre class="programlisting"><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * g_variant_new_signature (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *signature</code></em>);</pre>
1352
+ <p>
1353
+ Creates a DBus type signature <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> with the contents of
1354
+ <em class="parameter"><code>string</code></em>. <em class="parameter"><code>string</code></em> must be a valid DBus type signature. Use
1355
+ <a class="link" href="glib-GVariant.html#g-variant-is-signature" title="g_variant_is_signature ()"><code class="function">g_variant_is_signature()</code></a> if you're not sure.
1356
+ </p>
1357
+ <div class="variablelist"><table border="0">
1358
+ <col align="left" valign="top">
1359
+ <tbody>
1360
+ <tr>
1361
+ <td><p><span class="term"><em class="parameter"><code>signature</code></em> :</span></p></td>
1362
+ <td>a normal C nul-terminated string
1363
+ </td>
1364
+ </tr>
1365
+ <tr>
1366
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1367
+ <td>a new signature <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance
1368
+ </td>
1369
+ </tr>
1370
+ </tbody>
1371
+ </table></div>
1372
+ <p class="since">Since 2.24</p>
1373
+ </div>
1374
+ <hr>
1375
+ <div class="refsect2" title="g_variant_is_signature ()">
1376
+ <a name="g-variant-is-signature"></a><h3>g_variant_is_signature ()</h3>
1377
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_variant_is_signature (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *string</code></em>);</pre>
1378
+ <p>
1379
+ Determines if a given string is a valid DBus type signature. You
1380
+ should ensure that a string is a valid DBus object path before
1381
+ passing it to <a class="link" href="glib-GVariant.html#g-variant-new-signature" title="g_variant_new_signature ()"><code class="function">g_variant_new_signature()</code></a>.
1382
+ </p>
1383
+ <p>
1384
+ DBus type signatures consist of zero or more definite <a class="link" href="glib-GVariantType.html#GVariantType" title="GVariantType"><span class="type">GVariantType</span></a>
1385
+ strings in sequence.
1386
+ </p>
1387
+ <div class="variablelist"><table border="0">
1388
+ <col align="left" valign="top">
1389
+ <tbody>
1390
+ <tr>
1391
+ <td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
1392
+ <td>a normal C nul-terminated string
1393
+ </td>
1394
+ </tr>
1395
+ <tr>
1396
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1397
+ <td>
1398
+ <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if <em class="parameter"><code>string</code></em> is a DBus type signature
1399
+ </td>
1400
+ </tr>
1401
+ </tbody>
1402
+ </table></div>
1403
+ <p class="since">Since 2.24</p>
1404
+ </div>
1405
+ <hr>
1406
+ <div class="refsect2" title="g_variant_new_variant ()">
1407
+ <a name="g-variant-new-variant"></a><h3>g_variant_new_variant ()</h3>
1408
+ <pre class="programlisting"><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * g_variant_new_variant (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);</pre>
1409
+ <p>
1410
+ Boxes <em class="parameter"><code>value</code></em>. The result is a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance representing a
1411
+ variant containing the original value.
1412
+ </p>
1413
+ <div class="variablelist"><table border="0">
1414
+ <col align="left" valign="top">
1415
+ <tbody>
1416
+ <tr>
1417
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1418
+ <td>a <span class="type">GVariance</span> instance
1419
+ </td>
1420
+ </tr>
1421
+ <tr>
1422
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1423
+ <td>a new variant <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance
1424
+ </td>
1425
+ </tr>
1426
+ </tbody>
1427
+ </table></div>
1428
+ <p class="since">Since 2.24</p>
1429
+ </div>
1430
+ <hr>
1431
+ <div class="refsect2" title="g_variant_new_strv ()">
1432
+ <a name="g-variant-new-strv"></a><h3>g_variant_new_strv ()</h3>
1433
+ <pre class="programlisting"><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * g_variant_new_strv (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> * const *strv</code></em>,
1434
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> length</code></em>);</pre>
1435
+ <p>
1436
+ Constructs an array of strings <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> from the given array of
1437
+ strings.
1438
+ </p>
1439
+ <p>
1440
+ If <em class="parameter"><code>length</code></em> is not -1 then it gives the maximum length of <em class="parameter"><code>strv</code></em>. In
1441
+ any case, a <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> pointer in <em class="parameter"><code>strv</code></em> is taken as a terminator.
1442
+ </p>
1443
+ <div class="variablelist"><table border="0">
1444
+ <col align="left" valign="top">
1445
+ <tbody>
1446
+ <tr>
1447
+ <td><p><span class="term"><em class="parameter"><code>strv</code></em> :</span></p></td>
1448
+ <td>an array of strings
1449
+ </td>
1450
+ </tr>
1451
+ <tr>
1452
+ <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
1453
+ <td>the length of <em class="parameter"><code>strv</code></em>, or -1
1454
+ </td>
1455
+ </tr>
1456
+ <tr>
1457
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1458
+ <td>a new floating <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance
1459
+ </td>
1460
+ </tr>
1461
+ </tbody>
1462
+ </table></div>
1463
+ <p class="since">Since 2.24</p>
1464
+ </div>
1465
+ <hr>
1466
+ <div class="refsect2" title="g_variant_get_boolean ()">
1467
+ <a name="g-variant-get-boolean"></a><h3>g_variant_get_boolean ()</h3>
1468
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_variant_get_boolean (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);</pre>
1469
+ <p>
1470
+ Returns the boolean value of <em class="parameter"><code>value</code></em>.
1471
+ </p>
1472
+ <p>
1473
+ It is an error to call this function with a <em class="parameter"><code>value</code></em> of any type
1474
+ other than <a class="link" href="glib-GVariantType.html#G-VARIANT-TYPE-BOOLEAN:CAPS" title="G_VARIANT_TYPE_BOOLEAN"><code class="literal">G_VARIANT_TYPE_BOOLEAN</code></a>.
1475
+ </p>
1476
+ <div class="variablelist"><table border="0">
1477
+ <col align="left" valign="top">
1478
+ <tbody>
1479
+ <tr>
1480
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1481
+ <td>a boolean <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance
1482
+ </td>
1483
+ </tr>
1484
+ <tr>
1485
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1486
+ <td>
1487
+ <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> or <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a>
1488
+ </td>
1489
+ </tr>
1490
+ </tbody>
1491
+ </table></div>
1492
+ <p class="since">Since 2.24</p>
1493
+ </div>
1494
+ <hr>
1495
+ <div class="refsect2" title="g_variant_get_byte ()">
1496
+ <a name="g-variant-get-byte"></a><h3>g_variant_get_byte ()</h3>
1497
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guchar" title="guchar"><span class="returnvalue">guchar</span></a> g_variant_get_byte (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);</pre>
1498
+ <p>
1499
+ Returns the byte value of <em class="parameter"><code>value</code></em>.
1500
+ </p>
1501
+ <p>
1502
+ It is an error to call this function with a <em class="parameter"><code>value</code></em> of any type
1503
+ other than <a class="link" href="glib-GVariantType.html#G-VARIANT-TYPE-BYTE:CAPS" title="G_VARIANT_TYPE_BYTE"><code class="literal">G_VARIANT_TYPE_BYTE</code></a>.
1504
+ </p>
1505
+ <div class="variablelist"><table border="0">
1506
+ <col align="left" valign="top">
1507
+ <tbody>
1508
+ <tr>
1509
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1510
+ <td>a byte <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance
1511
+ </td>
1512
+ </tr>
1513
+ <tr>
1514
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1515
+ <td>a <a class="link" href="glib-Basic-Types.html#guchar" title="guchar"><span class="type">guchar</span></a>
1516
+ </td>
1517
+ </tr>
1518
+ </tbody>
1519
+ </table></div>
1520
+ <p class="since">Since 2.24</p>
1521
+ </div>
1522
+ <hr>
1523
+ <div class="refsect2" title="g_variant_get_int16 ()">
1524
+ <a name="g-variant-get-int16"></a><h3>g_variant_get_int16 ()</h3>
1525
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint16" title="gint16"><span class="returnvalue">gint16</span></a> g_variant_get_int16 (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);</pre>
1526
+ <p>
1527
+ Returns the 16-bit signed integer value of <em class="parameter"><code>value</code></em>.
1528
+ </p>
1529
+ <p>
1530
+ It is an error to call this function with a <em class="parameter"><code>value</code></em> of any type
1531
+ other than <a class="link" href="glib-GVariantType.html#G-VARIANT-TYPE-INT16:CAPS" title="G_VARIANT_TYPE_INT16"><code class="literal">G_VARIANT_TYPE_INT16</code></a>.
1532
+ </p>
1533
+ <div class="variablelist"><table border="0">
1534
+ <col align="left" valign="top">
1535
+ <tbody>
1536
+ <tr>
1537
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1538
+ <td>a int16 <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance
1539
+ </td>
1540
+ </tr>
1541
+ <tr>
1542
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1543
+ <td>a <a class="link" href="glib-Basic-Types.html#gint16" title="gint16"><span class="type">gint16</span></a>
1544
+ </td>
1545
+ </tr>
1546
+ </tbody>
1547
+ </table></div>
1548
+ <p class="since">Since 2.24</p>
1549
+ </div>
1550
+ <hr>
1551
+ <div class="refsect2" title="g_variant_get_uint16 ()">
1552
+ <a name="g-variant-get-uint16"></a><h3>g_variant_get_uint16 ()</h3>
1553
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint16" title="guint16"><span class="returnvalue">guint16</span></a> g_variant_get_uint16 (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);</pre>
1554
+ <p>
1555
+ Returns the 16-bit unsigned integer value of <em class="parameter"><code>value</code></em>.
1556
+ </p>
1557
+ <p>
1558
+ It is an error to call this function with a <em class="parameter"><code>value</code></em> of any type
1559
+ other than <a class="link" href="glib-GVariantType.html#G-VARIANT-TYPE-UINT16:CAPS" title="G_VARIANT_TYPE_UINT16"><code class="literal">G_VARIANT_TYPE_UINT16</code></a>.
1560
+ </p>
1561
+ <div class="variablelist"><table border="0">
1562
+ <col align="left" valign="top">
1563
+ <tbody>
1564
+ <tr>
1565
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1566
+ <td>a uint16 <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance
1567
+ </td>
1568
+ </tr>
1569
+ <tr>
1570
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1571
+ <td>a <a class="link" href="glib-Basic-Types.html#guint16" title="guint16"><span class="type">guint16</span></a>
1572
+ </td>
1573
+ </tr>
1574
+ </tbody>
1575
+ </table></div>
1576
+ <p class="since">Since 2.24</p>
1577
+ </div>
1578
+ <hr>
1579
+ <div class="refsect2" title="g_variant_get_int32 ()">
1580
+ <a name="g-variant-get-int32"></a><h3>g_variant_get_int32 ()</h3>
1581
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint32" title="gint32"><span class="returnvalue">gint32</span></a> g_variant_get_int32 (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);</pre>
1582
+ <p>
1583
+ Returns the 32-bit signed integer value of <em class="parameter"><code>value</code></em>.
1584
+ </p>
1585
+ <p>
1586
+ It is an error to call this function with a <em class="parameter"><code>value</code></em> of any type
1587
+ other than <a class="link" href="glib-GVariantType.html#G-VARIANT-TYPE-INT32:CAPS" title="G_VARIANT_TYPE_INT32"><code class="literal">G_VARIANT_TYPE_INT32</code></a>.
1588
+ </p>
1589
+ <div class="variablelist"><table border="0">
1590
+ <col align="left" valign="top">
1591
+ <tbody>
1592
+ <tr>
1593
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1594
+ <td>a int32 <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance
1595
+ </td>
1596
+ </tr>
1597
+ <tr>
1598
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1599
+ <td>a <a class="link" href="glib-Basic-Types.html#gint32" title="gint32"><span class="type">gint32</span></a>
1600
+ </td>
1601
+ </tr>
1602
+ </tbody>
1603
+ </table></div>
1604
+ <p class="since">Since 2.24</p>
1605
+ </div>
1606
+ <hr>
1607
+ <div class="refsect2" title="g_variant_get_uint32 ()">
1608
+ <a name="g-variant-get-uint32"></a><h3>g_variant_get_uint32 ()</h3>
1609
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint32" title="guint32"><span class="returnvalue">guint32</span></a> g_variant_get_uint32 (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);</pre>
1610
+ <p>
1611
+ Returns the 32-bit unsigned integer value of <em class="parameter"><code>value</code></em>.
1612
+ </p>
1613
+ <p>
1614
+ It is an error to call this function with a <em class="parameter"><code>value</code></em> of any type
1615
+ other than <a class="link" href="glib-GVariantType.html#G-VARIANT-TYPE-UINT32:CAPS" title="G_VARIANT_TYPE_UINT32"><code class="literal">G_VARIANT_TYPE_UINT32</code></a>.
1616
+ </p>
1617
+ <div class="variablelist"><table border="0">
1618
+ <col align="left" valign="top">
1619
+ <tbody>
1620
+ <tr>
1621
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1622
+ <td>a uint32 <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance
1623
+ </td>
1624
+ </tr>
1625
+ <tr>
1626
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1627
+ <td>a <a class="link" href="glib-Basic-Types.html#guint32" title="guint32"><span class="type">guint32</span></a>
1628
+ </td>
1629
+ </tr>
1630
+ </tbody>
1631
+ </table></div>
1632
+ <p class="since">Since 2.24</p>
1633
+ </div>
1634
+ <hr>
1635
+ <div class="refsect2" title="g_variant_get_int64 ()">
1636
+ <a name="g-variant-get-int64"></a><h3>g_variant_get_int64 ()</h3>
1637
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint64" title="gint64"><span class="returnvalue">gint64</span></a> g_variant_get_int64 (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);</pre>
1638
+ <p>
1639
+ Returns the 64-bit signed integer value of <em class="parameter"><code>value</code></em>.
1640
+ </p>
1641
+ <p>
1642
+ It is an error to call this function with a <em class="parameter"><code>value</code></em> of any type
1643
+ other than <a class="link" href="glib-GVariantType.html#G-VARIANT-TYPE-INT64:CAPS" title="G_VARIANT_TYPE_INT64"><code class="literal">G_VARIANT_TYPE_INT64</code></a>.
1644
+ </p>
1645
+ <div class="variablelist"><table border="0">
1646
+ <col align="left" valign="top">
1647
+ <tbody>
1648
+ <tr>
1649
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1650
+ <td>a int64 <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance
1651
+ </td>
1652
+ </tr>
1653
+ <tr>
1654
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1655
+ <td>a <a class="link" href="glib-Basic-Types.html#gint64" title="gint64"><span class="type">gint64</span></a>
1656
+ </td>
1657
+ </tr>
1658
+ </tbody>
1659
+ </table></div>
1660
+ <p class="since">Since 2.24</p>
1661
+ </div>
1662
+ <hr>
1663
+ <div class="refsect2" title="g_variant_get_uint64 ()">
1664
+ <a name="g-variant-get-uint64"></a><h3>g_variant_get_uint64 ()</h3>
1665
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint64" title="guint64"><span class="returnvalue">guint64</span></a> g_variant_get_uint64 (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);</pre>
1666
+ <p>
1667
+ Returns the 64-bit unsigned integer value of <em class="parameter"><code>value</code></em>.
1668
+ </p>
1669
+ <p>
1670
+ It is an error to call this function with a <em class="parameter"><code>value</code></em> of any type
1671
+ other than <a class="link" href="glib-GVariantType.html#G-VARIANT-TYPE-UINT64:CAPS" title="G_VARIANT_TYPE_UINT64"><code class="literal">G_VARIANT_TYPE_UINT64</code></a>.
1672
+ </p>
1673
+ <div class="variablelist"><table border="0">
1674
+ <col align="left" valign="top">
1675
+ <tbody>
1676
+ <tr>
1677
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1678
+ <td>a uint64 <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance
1679
+ </td>
1680
+ </tr>
1681
+ <tr>
1682
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1683
+ <td>a <a class="link" href="glib-Basic-Types.html#guint64" title="guint64"><span class="type">guint64</span></a>
1684
+ </td>
1685
+ </tr>
1686
+ </tbody>
1687
+ </table></div>
1688
+ <p class="since">Since 2.24</p>
1689
+ </div>
1690
+ <hr>
1691
+ <div class="refsect2" title="g_variant_get_handle ()">
1692
+ <a name="g-variant-get-handle"></a><h3>g_variant_get_handle ()</h3>
1693
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint32" title="gint32"><span class="returnvalue">gint32</span></a> g_variant_get_handle (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);</pre>
1694
+ <p>
1695
+ Returns the 32-bit signed integer value of <em class="parameter"><code>value</code></em>.
1696
+ </p>
1697
+ <p>
1698
+ It is an error to call this function with a <em class="parameter"><code>value</code></em> of any type other
1699
+ than <a class="link" href="glib-GVariantType.html#G-VARIANT-TYPE-HANDLE:CAPS" title="G_VARIANT_TYPE_HANDLE"><code class="literal">G_VARIANT_TYPE_HANDLE</code></a>.
1700
+ </p>
1701
+ <p>
1702
+ By convention, handles are indexes into an array of file descriptors
1703
+ that are sent alongside a DBus message. If you're not interacting
1704
+ with DBus, you probably don't need them.
1705
+ </p>
1706
+ <div class="variablelist"><table border="0">
1707
+ <col align="left" valign="top">
1708
+ <tbody>
1709
+ <tr>
1710
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1711
+ <td>a handle <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance
1712
+ </td>
1713
+ </tr>
1714
+ <tr>
1715
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1716
+ <td>a <a class="link" href="glib-Basic-Types.html#gint32" title="gint32"><span class="type">gint32</span></a>
1717
+ </td>
1718
+ </tr>
1719
+ </tbody>
1720
+ </table></div>
1721
+ <p class="since">Since 2.24</p>
1722
+ </div>
1723
+ <hr>
1724
+ <div class="refsect2" title="g_variant_get_double ()">
1725
+ <a name="g-variant-get-double"></a><h3>g_variant_get_double ()</h3>
1726
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gdouble" title="gdouble"><span class="returnvalue">gdouble</span></a> g_variant_get_double (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);</pre>
1727
+ <p>
1728
+ Returns the double precision floating point value of <em class="parameter"><code>value</code></em>.
1729
+ </p>
1730
+ <p>
1731
+ It is an error to call this function with a <em class="parameter"><code>value</code></em> of any type
1732
+ other than <a class="link" href="glib-GVariantType.html#G-VARIANT-TYPE-DOUBLE:CAPS" title="G_VARIANT_TYPE_DOUBLE"><code class="literal">G_VARIANT_TYPE_DOUBLE</code></a>.
1733
+ </p>
1734
+ <div class="variablelist"><table border="0">
1735
+ <col align="left" valign="top">
1736
+ <tbody>
1737
+ <tr>
1738
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1739
+ <td>a double <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance
1740
+ </td>
1741
+ </tr>
1742
+ <tr>
1743
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1744
+ <td>a <a class="link" href="glib-Basic-Types.html#gdouble" title="gdouble"><span class="type">gdouble</span></a>
1745
+ </td>
1746
+ </tr>
1747
+ </tbody>
1748
+ </table></div>
1749
+ <p class="since">Since 2.24</p>
1750
+ </div>
1751
+ <hr>
1752
+ <div class="refsect2" title="g_variant_get_string ()">
1753
+ <a name="g-variant-get-string"></a><h3>g_variant_get_string ()</h3>
1754
+ <pre class="programlisting">const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_variant_get_string (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>,
1755
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *length</code></em>);</pre>
1756
+ <p>
1757
+ Returns the string value of a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance with a string
1758
+ type. This includes the types <a class="link" href="glib-GVariantType.html#G-VARIANT-TYPE-STRING:CAPS" title="G_VARIANT_TYPE_STRING"><code class="literal">G_VARIANT_TYPE_STRING</code></a>,
1759
+ <a class="link" href="glib-GVariantType.html#G-VARIANT-TYPE-OBJECT-PATH:CAPS" title="G_VARIANT_TYPE_OBJECT_PATH"><code class="literal">G_VARIANT_TYPE_OBJECT_PATH</code></a> and <a class="link" href="glib-GVariantType.html#G-VARIANT-TYPE-SIGNATURE:CAPS" title="G_VARIANT_TYPE_SIGNATURE"><code class="literal">G_VARIANT_TYPE_SIGNATURE</code></a>.
1760
+ </p>
1761
+ <p>
1762
+ If <em class="parameter"><code>length</code></em> is non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> then the length of the string (in bytes) is
1763
+ returned there. For trusted values, this information is already
1764
+ known. For untrusted values, a <code class="function">strlen()</code> will be performed.
1765
+ </p>
1766
+ <p>
1767
+ It is an error to call this function with a <em class="parameter"><code>value</code></em> of any type
1768
+ other than those three.
1769
+ </p>
1770
+ <p>
1771
+ The return value remains valid as long as <em class="parameter"><code>value</code></em> exists.
1772
+ </p>
1773
+ <div class="variablelist"><table border="0">
1774
+ <col align="left" valign="top">
1775
+ <tbody>
1776
+ <tr>
1777
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1778
+ <td>a string <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance
1779
+ </td>
1780
+ </tr>
1781
+ <tr>
1782
+ <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
1783
+ <td>a pointer to a <a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a>, to store the length
1784
+ </td>
1785
+ </tr>
1786
+ <tr>
1787
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1788
+ <td>the constant string
1789
+ </td>
1790
+ </tr>
1791
+ </tbody>
1792
+ </table></div>
1793
+ <p class="since">Since 2.24</p>
1794
+ </div>
1795
+ <hr>
1796
+ <div class="refsect2" title="g_variant_dup_string ()">
1797
+ <a name="g-variant-dup-string"></a><h3>g_variant_dup_string ()</h3>
1798
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_variant_dup_string (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>,
1799
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *length</code></em>);</pre>
1800
+ <p>
1801
+ Similar to <a class="link" href="glib-GVariant.html#g-variant-get-string" title="g_variant_get_string ()"><code class="function">g_variant_get_string()</code></a> except that instead of returning
1802
+ a constant string, the string is duplicated.
1803
+ </p>
1804
+ <p>
1805
+ The return value must be freed using <a class="link" href="glib-Memory-Allocation.html#g-free" title="g_free ()"><code class="function">g_free()</code></a>.
1806
+ </p>
1807
+ <div class="variablelist"><table border="0">
1808
+ <col align="left" valign="top">
1809
+ <tbody>
1810
+ <tr>
1811
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1812
+ <td>a string <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance
1813
+ </td>
1814
+ </tr>
1815
+ <tr>
1816
+ <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
1817
+ <td>a pointer to a <a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a>, to store the length
1818
+ </td>
1819
+ </tr>
1820
+ <tr>
1821
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1822
+ <td>a newly allocated string
1823
+ </td>
1824
+ </tr>
1825
+ </tbody>
1826
+ </table></div>
1827
+ <p class="since">Since 2.24</p>
1828
+ </div>
1829
+ <hr>
1830
+ <div class="refsect2" title="g_variant_get_variant ()">
1831
+ <a name="g-variant-get-variant"></a><h3>g_variant_get_variant ()</h3>
1832
+ <pre class="programlisting"><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * g_variant_get_variant (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);</pre>
1833
+ <p>
1834
+ Unboxes <em class="parameter"><code>value</code></em>. The result is the <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance that was
1835
+ contained in <em class="parameter"><code>value</code></em>.
1836
+ </p>
1837
+ <div class="variablelist"><table border="0">
1838
+ <col align="left" valign="top">
1839
+ <tbody>
1840
+ <tr>
1841
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1842
+ <td>a variant <span class="type">GVariance</span> instance
1843
+ </td>
1844
+ </tr>
1845
+ <tr>
1846
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1847
+ <td>the item contained in the variant
1848
+ </td>
1849
+ </tr>
1850
+ </tbody>
1851
+ </table></div>
1852
+ <p class="since">Since 2.24</p>
1853
+ </div>
1854
+ <hr>
1855
+ <div class="refsect2" title="g_variant_get_strv ()">
1856
+ <a name="g-variant-get-strv"></a><h3>g_variant_get_strv ()</h3>
1857
+ <pre class="programlisting">const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> ** g_variant_get_strv (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>,
1858
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *length</code></em>);</pre>
1859
+ <p>
1860
+ Gets the contents of an array of strings <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>. This call
1861
+ makes a shallow copy; the return result should be released with
1862
+ <a class="link" href="glib-Memory-Allocation.html#g-free" title="g_free ()"><code class="function">g_free()</code></a>, but the individual strings must not be modified.
1863
+ </p>
1864
+ <p>
1865
+ If <em class="parameter"><code>length</code></em> is non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> then the number of elements in the result
1866
+ is stored there. In any case, the resulting array will be
1867
+ <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated.
1868
+ </p>
1869
+ <p>
1870
+ For an empty array, <em class="parameter"><code>length</code></em> will be set to 0 and a pointer to a
1871
+ <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> pointer will be returned.
1872
+ </p>
1873
+ <div class="variablelist"><table border="0">
1874
+ <col align="left" valign="top">
1875
+ <tbody>
1876
+ <tr>
1877
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1878
+ <td>an array of strings <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>
1879
+ </td>
1880
+ </tr>
1881
+ <tr>
1882
+ <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
1883
+ <td>the length of the result, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
1884
+ </td>
1885
+ </tr>
1886
+ <tr>
1887
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1888
+ <td>an array of constant strings
1889
+ </td>
1890
+ </tr>
1891
+ </tbody>
1892
+ </table></div>
1893
+ <p class="since">Since 2.24</p>
1894
+ </div>
1895
+ <hr>
1896
+ <div class="refsect2" title="g_variant_dup_strv ()">
1897
+ <a name="g-variant-dup-strv"></a><h3>g_variant_dup_strv ()</h3>
1898
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> ** g_variant_dup_strv (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>,
1899
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *length</code></em>);</pre>
1900
+ <p>
1901
+ Gets the contents of an array of strings <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>. This call
1902
+ makes a deep copy; the return result should be released with
1903
+ <a class="link" href="glib-String-Utility-Functions.html#g-strfreev" title="g_strfreev ()"><code class="function">g_strfreev()</code></a>.
1904
+ </p>
1905
+ <p>
1906
+ If <em class="parameter"><code>length</code></em> is non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> then the number of elements in the result
1907
+ is stored there. In any case, the resulting array will be
1908
+ <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated.
1909
+ </p>
1910
+ <p>
1911
+ For an empty array, <em class="parameter"><code>length</code></em> will be set to 0 and a pointer to a
1912
+ <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> pointer will be returned.
1913
+ </p>
1914
+ <div class="variablelist"><table border="0">
1915
+ <col align="left" valign="top">
1916
+ <tbody>
1917
+ <tr>
1918
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1919
+ <td>an array of strings <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>
1920
+ </td>
1921
+ </tr>
1922
+ <tr>
1923
+ <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
1924
+ <td>the length of the result, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
1925
+ </td>
1926
+ </tr>
1927
+ <tr>
1928
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1929
+ <td>an array of constant strings
1930
+ </td>
1931
+ </tr>
1932
+ </tbody>
1933
+ </table></div>
1934
+ <p class="since">Since 2.24</p>
1935
+ </div>
1936
+ <hr>
1937
+ <div class="refsect2" title="g_variant_new_maybe ()">
1938
+ <a name="g-variant-new-maybe"></a><h3>g_variant_new_maybe ()</h3>
1939
+ <pre class="programlisting"><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * g_variant_new_maybe (<em class="parameter"><code>const <a class="link" href="glib-GVariantType.html#GVariantType" title="GVariantType"><span class="type">GVariantType</span></a> *child_type</code></em>,
1940
+ <em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *child</code></em>);</pre>
1941
+ <p>
1942
+ Depending on if <em class="parameter"><code>value</code></em> is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, either wraps <em class="parameter"><code>value</code></em> inside of a
1943
+ maybe container or creates a Nothing instance for the given <em class="parameter"><code>type</code></em>.
1944
+ </p>
1945
+ <p>
1946
+ At least one of <em class="parameter"><code>type</code></em> and <em class="parameter"><code>value</code></em> must be non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. If <em class="parameter"><code>type</code></em> is
1947
+ non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> then it must be a definite type. If they are both
1948
+ non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> then <em class="parameter"><code>type</code></em> must be the type of <em class="parameter"><code>value</code></em>.
1949
+ </p>
1950
+ <div class="variablelist"><table border="0">
1951
+ <col align="left" valign="top">
1952
+ <tbody>
1953
+ <tr>
1954
+ <td><p><span class="term"><em class="parameter"><code>child_type</code></em> :</span></p></td>
1955
+ <td>the <a class="link" href="glib-GVariantType.html#GVariantType" title="GVariantType"><span class="type">GVariantType</span></a> of the child
1956
+ </td>
1957
+ </tr>
1958
+ <tr>
1959
+ <td><p><span class="term"><em class="parameter"><code>child</code></em> :</span></p></td>
1960
+ <td>the child value, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
1961
+ </td>
1962
+ </tr>
1963
+ <tr>
1964
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1965
+ <td>a new <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> maybe instance
1966
+ </td>
1967
+ </tr>
1968
+ </tbody>
1969
+ </table></div>
1970
+ <p class="since">Since 2.24</p>
1971
+ </div>
1972
+ <hr>
1973
+ <div class="refsect2" title="g_variant_new_array ()">
1974
+ <a name="g-variant-new-array"></a><h3>g_variant_new_array ()</h3>
1975
+ <pre class="programlisting"><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * g_variant_new_array (<em class="parameter"><code>const <a class="link" href="glib-GVariantType.html#GVariantType" title="GVariantType"><span class="type">GVariantType</span></a> *child_type</code></em>,
1976
+ <em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> * const *children</code></em>,
1977
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> n_children</code></em>);</pre>
1978
+ <p>
1979
+ Creates a new <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> array from <em class="parameter"><code>children</code></em>.
1980
+ </p>
1981
+ <p>
1982
+ <em class="parameter"><code>child_type</code></em> must be non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if <em class="parameter"><code>n_children</code></em> is zero. Otherwise, the
1983
+ child type is determined by inspecting the first element of the
1984
+ <em class="parameter"><code>children</code></em> array. If <em class="parameter"><code>child_type</code></em> is non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> then it must be a
1985
+ definite type.
1986
+ </p>
1987
+ <p>
1988
+ The items of the array are taken from the <em class="parameter"><code>children</code></em> array. No entry
1989
+ in the <em class="parameter"><code>children</code></em> array may be <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
1990
+ </p>
1991
+ <p>
1992
+ All items in the array must have the same type, which must be the
1993
+ same as <em class="parameter"><code>child_type</code></em>, if given.
1994
+ </p>
1995
+ <div class="variablelist"><table border="0">
1996
+ <col align="left" valign="top">
1997
+ <tbody>
1998
+ <tr>
1999
+ <td><p><span class="term"><em class="parameter"><code>child_type</code></em> :</span></p></td>
2000
+ <td>the element type of the new array
2001
+ </td>
2002
+ </tr>
2003
+ <tr>
2004
+ <td><p><span class="term"><em class="parameter"><code>children</code></em> :</span></p></td>
2005
+ <td>an array of <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> pointers, the children
2006
+ </td>
2007
+ </tr>
2008
+ <tr>
2009
+ <td><p><span class="term"><em class="parameter"><code>n_children</code></em> :</span></p></td>
2010
+ <td>the length of <em class="parameter"><code>children</code></em>
2011
+ </td>
2012
+ </tr>
2013
+ <tr>
2014
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2015
+ <td>a new <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> array
2016
+ </td>
2017
+ </tr>
2018
+ </tbody>
2019
+ </table></div>
2020
+ <p class="since">Since 2.24</p>
2021
+ </div>
2022
+ <hr>
2023
+ <div class="refsect2" title="g_variant_new_tuple ()">
2024
+ <a name="g-variant-new-tuple"></a><h3>g_variant_new_tuple ()</h3>
2025
+ <pre class="programlisting"><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * g_variant_new_tuple (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> * const *children</code></em>,
2026
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> n_children</code></em>);</pre>
2027
+ <p>
2028
+ Creates a new tuple <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> out of the items in <em class="parameter"><code>children</code></em>. The
2029
+ type is determined from the types of <em class="parameter"><code>children</code></em>. No entry in the
2030
+ <em class="parameter"><code>children</code></em> array may be <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
2031
+ </p>
2032
+ <p>
2033
+ If <em class="parameter"><code>n_children</code></em> is 0 then the unit tuple is constructed.
2034
+ </p>
2035
+ <div class="variablelist"><table border="0">
2036
+ <col align="left" valign="top">
2037
+ <tbody>
2038
+ <tr>
2039
+ <td><p><span class="term"><em class="parameter"><code>children</code></em> :</span></p></td>
2040
+ <td>the items to make the tuple out of
2041
+ </td>
2042
+ </tr>
2043
+ <tr>
2044
+ <td><p><span class="term"><em class="parameter"><code>n_children</code></em> :</span></p></td>
2045
+ <td>the length of <em class="parameter"><code>children</code></em>
2046
+ </td>
2047
+ </tr>
2048
+ <tr>
2049
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2050
+ <td>a new <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> tuple
2051
+ </td>
2052
+ </tr>
2053
+ </tbody>
2054
+ </table></div>
2055
+ <p class="since">Since 2.24</p>
2056
+ </div>
2057
+ <hr>
2058
+ <div class="refsect2" title="g_variant_new_dict_entry ()">
2059
+ <a name="g-variant-new-dict-entry"></a><h3>g_variant_new_dict_entry ()</h3>
2060
+ <pre class="programlisting"><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * g_variant_new_dict_entry (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *key</code></em>,
2061
+ <em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);</pre>
2062
+ <p>
2063
+ Creates a new dictionary entry <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>. <em class="parameter"><code>key</code></em> and <em class="parameter"><code>value</code></em> must be
2064
+ non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
2065
+ </p>
2066
+ <p>
2067
+ <em class="parameter"><code>key</code></em> must be a value of a basic type (ie: not a container).
2068
+ </p>
2069
+ <div class="variablelist"><table border="0">
2070
+ <col align="left" valign="top">
2071
+ <tbody>
2072
+ <tr>
2073
+ <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
2074
+ <td>a basic <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>, the key
2075
+ </td>
2076
+ </tr>
2077
+ <tr>
2078
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
2079
+ <td>a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>, the value
2080
+ </td>
2081
+ </tr>
2082
+ <tr>
2083
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2084
+ <td>a new dictionary entry <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>
2085
+ </td>
2086
+ </tr>
2087
+ </tbody>
2088
+ </table></div>
2089
+ <p class="since">Since 2.24</p>
2090
+ </div>
2091
+ <hr>
2092
+ <div class="refsect2" title="g_variant_get_maybe ()">
2093
+ <a name="g-variant-get-maybe"></a><h3>g_variant_get_maybe ()</h3>
2094
+ <pre class="programlisting"><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * g_variant_get_maybe (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);</pre>
2095
+ <p>
2096
+ Given a maybe-typed <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance, extract its value. If the
2097
+ value is Nothing, then this function returns <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
2098
+ </p>
2099
+ <div class="variablelist"><table border="0">
2100
+ <col align="left" valign="top">
2101
+ <tbody>
2102
+ <tr>
2103
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
2104
+ <td>a maybe-typed value
2105
+ </td>
2106
+ </tr>
2107
+ <tr>
2108
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2109
+ <td>the contents of <em class="parameter"><code>value</code></em>, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
2110
+ </td>
2111
+ </tr>
2112
+ </tbody>
2113
+ </table></div>
2114
+ <p class="since">Since 2.24</p>
2115
+ </div>
2116
+ <hr>
2117
+ <div class="refsect2" title="g_variant_n_children ()">
2118
+ <a name="g-variant-n-children"></a><h3>g_variant_n_children ()</h3>
2119
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="returnvalue">gsize</span></a> g_variant_n_children (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);</pre>
2120
+ <p>
2121
+ Determines the number of children in a container <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance.
2122
+ This includes variants, maybes, arrays, tuples and dictionary
2123
+ entries. It is an error to call this function on any other type of
2124
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>.
2125
+ </p>
2126
+ <p>
2127
+ For variants, the return value is always 1. For values with maybe
2128
+ types, it is always zero or one. For arrays, it is the length of the
2129
+ array. For tuples it is the number of tuple items (which depends
2130
+ only on the type). For dictionary entries, it is always 2
2131
+ </p>
2132
+ <p>
2133
+ This function is O(1).
2134
+ </p>
2135
+ <div class="variablelist"><table border="0">
2136
+ <col align="left" valign="top">
2137
+ <tbody>
2138
+ <tr>
2139
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
2140
+ <td>a container <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>
2141
+ </td>
2142
+ </tr>
2143
+ <tr>
2144
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2145
+ <td>the number of children in the container
2146
+ </td>
2147
+ </tr>
2148
+ </tbody>
2149
+ </table></div>
2150
+ <p class="since">Since 2.24</p>
2151
+ </div>
2152
+ <hr>
2153
+ <div class="refsect2" title="g_variant_get_child_value ()">
2154
+ <a name="g-variant-get-child-value"></a><h3>g_variant_get_child_value ()</h3>
2155
+ <pre class="programlisting"><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * g_variant_get_child_value (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>,
2156
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> index_</code></em>);</pre>
2157
+ <p>
2158
+ Reads a child item out of a container <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance. This
2159
+ includes variants, maybes, arrays, tuples and dictionary
2160
+ entries. It is an error to call this function on any other type of
2161
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>.
2162
+ </p>
2163
+ <p>
2164
+ It is an error if <em class="parameter"><code>index_</code></em> is greater than the number of child items
2165
+ in the container. See <a class="link" href="glib-GVariant.html#g-variant-n-children" title="g_variant_n_children ()"><code class="function">g_variant_n_children()</code></a>.
2166
+ </p>
2167
+ <p>
2168
+ This function is O(1).
2169
+ </p>
2170
+ <div class="variablelist"><table border="0">
2171
+ <col align="left" valign="top">
2172
+ <tbody>
2173
+ <tr>
2174
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
2175
+ <td>a container <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>
2176
+ </td>
2177
+ </tr>
2178
+ <tr>
2179
+ <td><p><span class="term"><em class="parameter"><code>index_</code></em> :</span></p></td>
2180
+ <td>the index of the child to fetch
2181
+ </td>
2182
+ </tr>
2183
+ <tr>
2184
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2185
+ <td>the child at the specified index
2186
+ </td>
2187
+ </tr>
2188
+ </tbody>
2189
+ </table></div>
2190
+ <p class="since">Since 2.24</p>
2191
+ </div>
2192
+ <hr>
2193
+ <div class="refsect2" title="g_variant_get_child ()">
2194
+ <a name="g-variant-get-child"></a><h3>g_variant_get_child ()</h3>
2195
+ <pre class="programlisting"><span class="returnvalue">void</span> g_variant_get_child (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>,
2196
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> index_</code></em>,
2197
+ <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *format_string</code></em>,
2198
+ <em class="parameter"><code>...</code></em>);</pre>
2199
+ <p>
2200
+ Reads a child item out of a container <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance and
2201
+ deconstructs it according to <em class="parameter"><code>format_string</code></em>. This call is
2202
+ essentially a combination of <a class="link" href="glib-GVariant.html#g-variant-get-child-value" title="g_variant_get_child_value ()"><code class="function">g_variant_get_child_value()</code></a> and
2203
+ <a class="link" href="glib-GVariant.html#g-variant-get" title="g_variant_get ()"><code class="function">g_variant_get()</code></a>.
2204
+ </p>
2205
+ <div class="variablelist"><table border="0">
2206
+ <col align="left" valign="top">
2207
+ <tbody>
2208
+ <tr>
2209
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
2210
+ <td>a container <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>
2211
+ </td>
2212
+ </tr>
2213
+ <tr>
2214
+ <td><p><span class="term"><em class="parameter"><code>index_</code></em> :</span></p></td>
2215
+ <td>the index of the child to deconstruct
2216
+ </td>
2217
+ </tr>
2218
+ <tr>
2219
+ <td><p><span class="term"><em class="parameter"><code>format_string</code></em> :</span></p></td>
2220
+ <td>a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> format string
2221
+ </td>
2222
+ </tr>
2223
+ <tr>
2224
+ <td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
2225
+ <td>arguments, as per <em class="parameter"><code>format_string</code></em>
2226
+ </td>
2227
+ </tr>
2228
+ </tbody>
2229
+ </table></div>
2230
+ <p class="since">Since 2.24</p>
2231
+ </div>
2232
+ <hr>
2233
+ <div class="refsect2" title="g_variant_get_fixed_array ()">
2234
+ <a name="g-variant-get-fixed-array"></a><h3>g_variant_get_fixed_array ()</h3>
2235
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer"><span class="returnvalue">gconstpointer</span></a> g_variant_get_fixed_array (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>,
2236
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *n_elements</code></em>,
2237
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> element_size</code></em>);</pre>
2238
+ <p>
2239
+ Provides access to the serialised data for an array of fixed-sized
2240
+ items.
2241
+ </p>
2242
+ <p>
2243
+ <em class="parameter"><code>value</code></em> must be an array with fixed-sized elements. Numeric types are
2244
+ fixed-size as are tuples containing only other fixed-sized types.
2245
+ </p>
2246
+ <p>
2247
+ <em class="parameter"><code>element_size</code></em> must be the size of a single element in the array. For
2248
+ example, if calling this function for an array of 32 bit integers,
2249
+ you might say <code class="code">sizeof (gint32)</code>. This value isn't used
2250
+ except for the purpose of a double-check that the form of the
2251
+ seralised data matches the caller's expectation.
2252
+ </p>
2253
+ <p>
2254
+ <em class="parameter"><code>n_elements</code></em>, which must be non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> is set equal to the number of
2255
+ items in the array.
2256
+ </p>
2257
+ <div class="variablelist"><table border="0">
2258
+ <col align="left" valign="top">
2259
+ <tbody>
2260
+ <tr>
2261
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
2262
+ <td>a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> array with fixed-sized elements
2263
+ </td>
2264
+ </tr>
2265
+ <tr>
2266
+ <td><p><span class="term"><em class="parameter"><code>n_elements</code></em> :</span></p></td>
2267
+ <td>a pointer to the location to store the number of items
2268
+ </td>
2269
+ </tr>
2270
+ <tr>
2271
+ <td><p><span class="term"><em class="parameter"><code>element_size</code></em> :</span></p></td>
2272
+ <td>the size of each element
2273
+ </td>
2274
+ </tr>
2275
+ <tr>
2276
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2277
+ <td>a pointer to the fixed array
2278
+ </td>
2279
+ </tr>
2280
+ </tbody>
2281
+ </table></div>
2282
+ <p class="since">Since 2.24</p>
2283
+ </div>
2284
+ <hr>
2285
+ <div class="refsect2" title="g_variant_get_size ()">
2286
+ <a name="g-variant-get-size"></a><h3>g_variant_get_size ()</h3>
2287
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="returnvalue">gsize</span></a> g_variant_get_size (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);</pre>
2288
+ <p>
2289
+ Determines the number of bytes that would be required to store <em class="parameter"><code>value</code></em>
2290
+ with <a class="link" href="glib-GVariant.html#g-variant-store" title="g_variant_store ()"><code class="function">g_variant_store()</code></a>.
2291
+ </p>
2292
+ <p>
2293
+ If <em class="parameter"><code>value</code></em> has a fixed-sized type then this function always returned
2294
+ that fixed size.
2295
+ </p>
2296
+ <p>
2297
+ In the case that <em class="parameter"><code>value</code></em> is already in serialised form or the size has
2298
+ already been calculated (ie: this function has been called before)
2299
+ then this function is O(1). Otherwise, the size is calculated, an
2300
+ operation which is approximately O(n) in the number of values
2301
+ involved.
2302
+ </p>
2303
+ <div class="variablelist"><table border="0">
2304
+ <col align="left" valign="top">
2305
+ <tbody>
2306
+ <tr>
2307
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
2308
+ <td>a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance
2309
+ </td>
2310
+ </tr>
2311
+ <tr>
2312
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2313
+ <td>the serialised size of <em class="parameter"><code>value</code></em>
2314
+ </td>
2315
+ </tr>
2316
+ </tbody>
2317
+ </table></div>
2318
+ <p class="since">Since 2.24</p>
2319
+ </div>
2320
+ <hr>
2321
+ <div class="refsect2" title="g_variant_get_data ()">
2322
+ <a name="g-variant-get-data"></a><h3>g_variant_get_data ()</h3>
2323
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer"><span class="returnvalue">gconstpointer</span></a> g_variant_get_data (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);</pre>
2324
+ <p>
2325
+ Returns a pointer to the serialised form of a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance.
2326
+ The returned data may not be in fully-normalised form if read from an
2327
+ untrusted source. The returned data must not be freed; it remains
2328
+ valid for as long as <em class="parameter"><code>value</code></em> exists.
2329
+ </p>
2330
+ <p>
2331
+ If <em class="parameter"><code>value</code></em> is a fixed-sized value that was deserialised from a
2332
+ corrupted serialised container then <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> may be returned. In this
2333
+ case, the proper thing to do is typically to use the appropriate
2334
+ number of nul bytes in place of <em class="parameter"><code>value</code></em>. If <em class="parameter"><code>value</code></em> is not fixed-sized
2335
+ then <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> is never returned.
2336
+ </p>
2337
+ <p>
2338
+ In the case that <em class="parameter"><code>value</code></em> is already in serialised form, this function
2339
+ is O(1). If the value is not already in serialised form,
2340
+ serialisation occurs implicitly and is approximately O(n) in the size
2341
+ of the result.
2342
+ </p>
2343
+ <div class="variablelist"><table border="0">
2344
+ <col align="left" valign="top">
2345
+ <tbody>
2346
+ <tr>
2347
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
2348
+ <td>a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance
2349
+ </td>
2350
+ </tr>
2351
+ <tr>
2352
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2353
+ <td>the serialised form of <em class="parameter"><code>value</code></em>, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
2354
+ </td>
2355
+ </tr>
2356
+ </tbody>
2357
+ </table></div>
2358
+ <p class="since">Since 2.24</p>
2359
+ </div>
2360
+ <hr>
2361
+ <div class="refsect2" title="g_variant_store ()">
2362
+ <a name="g-variant-store"></a><h3>g_variant_store ()</h3>
2363
+ <pre class="programlisting"><span class="returnvalue">void</span> g_variant_store (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>,
2364
+ <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>
2365
+ <p>
2366
+ Stores the serialised form of <em class="parameter"><code>value</code></em> at <em class="parameter"><code>data</code></em>. <em class="parameter"><code>data</code></em> should be
2367
+ large enough. See <a class="link" href="glib-GVariant.html#g-variant-get-size" title="g_variant_get_size ()"><code class="function">g_variant_get_size()</code></a>.
2368
+ </p>
2369
+ <p>
2370
+ The stored data is in machine native byte order but may not be in
2371
+ fully-normalised form if read from an untrusted source. See
2372
+ <code class="function">g_variant_normalise()</code> for a solution.
2373
+ </p>
2374
+ <p>
2375
+ This function is approximately O(n) in the size of <em class="parameter"><code>data</code></em>.
2376
+ </p>
2377
+ <div class="variablelist"><table border="0">
2378
+ <col align="left" valign="top">
2379
+ <tbody>
2380
+ <tr>
2381
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
2382
+ <td>the <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> to store
2383
+ </td>
2384
+ </tr>
2385
+ <tr>
2386
+ <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
2387
+ <td>the location to store the serialised data at
2388
+ </td>
2389
+ </tr>
2390
+ </tbody>
2391
+ </table></div>
2392
+ <p class="since">Since 2.24</p>
2393
+ </div>
2394
+ <hr>
2395
+ <div class="refsect2" title="g_variant_new_from_data ()">
2396
+ <a name="g-variant-new-from-data"></a><h3>g_variant_new_from_data ()</h3>
2397
+ <pre class="programlisting"><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * g_variant_new_from_data (<em class="parameter"><code>const <a class="link" href="glib-GVariantType.html#GVariantType" title="GVariantType"><span class="type">GVariantType</span></a> *type</code></em>,
2398
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer"><span class="type">gconstpointer</span></a> data</code></em>,
2399
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> size</code></em>,
2400
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="type">gboolean</span></a> trusted</code></em>,
2401
+ <em class="parameter"><code><a class="link" href="glib-Datasets.html#GDestroyNotify" title="GDestroyNotify ()"><span class="type">GDestroyNotify</span></a> notify</code></em>,
2402
+ <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>
2403
+ <p>
2404
+ Creates a new <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance from serialised data.
2405
+ </p>
2406
+ <p>
2407
+ <em class="parameter"><code>type</code></em> is the type of <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance that will be constructed.
2408
+ The interpretation of <em class="parameter"><code>data</code></em> depends on knowing the type.
2409
+ </p>
2410
+ <p>
2411
+ <em class="parameter"><code>data</code></em> is not modified by this function and must remain valid with an
2412
+ unchanging value until such a time as <em class="parameter"><code>notify</code></em> is called with
2413
+ <em class="parameter"><code>user_data</code></em>. If the contents of <em class="parameter"><code>data</code></em> change before that time then
2414
+ the result is undefined.
2415
+ </p>
2416
+ <p>
2417
+ If <em class="parameter"><code>data</code></em> is trusted to be serialised data in normal form then
2418
+ <em class="parameter"><code>trusted</code></em> should be <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a>. This applies to serialised data created
2419
+ within this process or read from a trusted location on the disk (such
2420
+ as a file installed in /usr/lib alongside your application). You
2421
+ should set trusted to <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> if <em class="parameter"><code>data</code></em> is read from the network, a
2422
+ file in the user's home directory, etc.
2423
+ </p>
2424
+ <p>
2425
+ <em class="parameter"><code>notify</code></em> will be called with <em class="parameter"><code>user_data</code></em> when <em class="parameter"><code>data</code></em> is no longer
2426
+ needed. The exact time of this call is unspecified and might even be
2427
+ before this function returns.
2428
+ </p>
2429
+ <div class="variablelist"><table border="0">
2430
+ <col align="left" valign="top">
2431
+ <tbody>
2432
+ <tr>
2433
+ <td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
2434
+ <td>a definite <a class="link" href="glib-GVariantType.html#GVariantType" title="GVariantType"><span class="type">GVariantType</span></a>
2435
+ </td>
2436
+ </tr>
2437
+ <tr>
2438
+ <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
2439
+ <td>the serialised data
2440
+ </td>
2441
+ </tr>
2442
+ <tr>
2443
+ <td><p><span class="term"><em class="parameter"><code>size</code></em> :</span></p></td>
2444
+ <td>the size of <em class="parameter"><code>data</code></em>
2445
+ </td>
2446
+ </tr>
2447
+ <tr>
2448
+ <td><p><span class="term"><em class="parameter"><code>trusted</code></em> :</span></p></td>
2449
+ <td>
2450
+ <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if <em class="parameter"><code>data</code></em> is definitely in normal form
2451
+ </td>
2452
+ </tr>
2453
+ <tr>
2454
+ <td><p><span class="term"><em class="parameter"><code>notify</code></em> :</span></p></td>
2455
+ <td>function to call when <em class="parameter"><code>data</code></em> is no longer needed
2456
+ </td>
2457
+ </tr>
2458
+ <tr>
2459
+ <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
2460
+ <td>data for <em class="parameter"><code>notify</code></em>
2461
+ </td>
2462
+ </tr>
2463
+ <tr>
2464
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2465
+ <td>a new floating <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> of type <em class="parameter"><code>type</code></em>
2466
+ </td>
2467
+ </tr>
2468
+ </tbody>
2469
+ </table></div>
2470
+ <p class="since">Since 2.24</p>
2471
+ </div>
2472
+ <hr>
2473
+ <div class="refsect2" title="g_variant_byteswap ()">
2474
+ <a name="g-variant-byteswap"></a><h3>g_variant_byteswap ()</h3>
2475
+ <pre class="programlisting"><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * g_variant_byteswap (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);</pre>
2476
+ <p>
2477
+ Performs a byteswapping operation on the contents of <em class="parameter"><code>value</code></em>. The
2478
+ result is that all multi-byte numeric data contained in <em class="parameter"><code>value</code></em> is
2479
+ byteswapped. That includes 16, 32, and 64bit signed and unsigned
2480
+ integers as well as file handles and double precision floating point
2481
+ values.
2482
+ </p>
2483
+ <p>
2484
+ This function is an identity mapping on any value that does not
2485
+ contain multi-byte numeric data. That include strings, booleans,
2486
+ bytes and containers containing only these things (recursively).
2487
+ </p>
2488
+ <p>
2489
+ The returned value is always in normal form and is marked as trusted.
2490
+ </p>
2491
+ <div class="variablelist"><table border="0">
2492
+ <col align="left" valign="top">
2493
+ <tbody>
2494
+ <tr>
2495
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
2496
+ <td>a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>
2497
+ </td>
2498
+ </tr>
2499
+ <tr>
2500
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2501
+ <td>the byteswapped form of <em class="parameter"><code>value</code></em>
2502
+ </td>
2503
+ </tr>
2504
+ </tbody>
2505
+ </table></div>
2506
+ <p class="since">Since 2.24</p>
2507
+ </div>
2508
+ <hr>
2509
+ <div class="refsect2" title="g_variant_get_normal_form ()">
2510
+ <a name="g-variant-get-normal-form"></a><h3>g_variant_get_normal_form ()</h3>
2511
+ <pre class="programlisting"><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * g_variant_get_normal_form (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);</pre>
2512
+ <p>
2513
+ Gets a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance that has the same value as <em class="parameter"><code>value</code></em> and is
2514
+ trusted to be in normal form.
2515
+ </p>
2516
+ <p>
2517
+ If <em class="parameter"><code>value</code></em> is already trusted to be in normal form then a new
2518
+ reference to <em class="parameter"><code>value</code></em> is returned.
2519
+ </p>
2520
+ <p>
2521
+ If <em class="parameter"><code>value</code></em> is not already trusted, then it is scanned to check if it
2522
+ is in normal form. If it is found to be in normal form then it is
2523
+ marked as trusted and a new reference to it is returned.
2524
+ </p>
2525
+ <p>
2526
+ If <em class="parameter"><code>value</code></em> is found not to be in normal form then a new trusted
2527
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> is created with the same value as <em class="parameter"><code>value</code></em>.
2528
+ </p>
2529
+ <p>
2530
+ It makes sense to call this function if you've received <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>
2531
+ data from untrusted sources and you want to ensure your serialised
2532
+ output is definitely in normal form.
2533
+ </p>
2534
+ <div class="variablelist"><table border="0">
2535
+ <col align="left" valign="top">
2536
+ <tbody>
2537
+ <tr>
2538
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
2539
+ <td>a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>
2540
+ </td>
2541
+ </tr>
2542
+ <tr>
2543
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2544
+ <td>a trusted <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>
2545
+ </td>
2546
+ </tr>
2547
+ </tbody>
2548
+ </table></div>
2549
+ <p class="since">Since 2.24</p>
2550
+ </div>
2551
+ <hr>
2552
+ <div class="refsect2" title="g_variant_is_normal_form ()">
2553
+ <a name="g-variant-is-normal-form"></a><h3>g_variant_is_normal_form ()</h3>
2554
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_variant_is_normal_form (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);</pre>
2555
+ <p>
2556
+ Checks if <em class="parameter"><code>value</code></em> is in normal form.
2557
+ </p>
2558
+ <p>
2559
+ The main reason to do this is to detect if a given chunk of
2560
+ serialised data is in normal form: load the data into a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>
2561
+ using <code class="function">g_variant_create_from_data()</code> and then use this function to
2562
+ check.
2563
+ </p>
2564
+ <p>
2565
+ If <em class="parameter"><code>value</code></em> is found to be in normal form then it will be marked as
2566
+ being trusted. If the value was already marked as being trusted then
2567
+ this function will immediately return <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a>.
2568
+ </p>
2569
+ <div class="variablelist"><table border="0">
2570
+ <col align="left" valign="top">
2571
+ <tbody>
2572
+ <tr>
2573
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
2574
+ <td>a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance
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>value</code></em> is in normal form
2581
+ </td>
2582
+ </tr>
2583
+ </tbody>
2584
+ </table></div>
2585
+ <p class="since">Since 2.24</p>
2586
+ </div>
2587
+ <hr>
2588
+ <div class="refsect2" title="g_variant_hash ()">
2589
+ <a name="g-variant-hash"></a><h3>g_variant_hash ()</h3>
2590
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="returnvalue">guint</span></a> g_variant_hash (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer"><span class="type">gconstpointer</span></a> value</code></em>);</pre>
2591
+ <p>
2592
+ Generates a hash value for a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance.
2593
+ </p>
2594
+ <p>
2595
+ The output of this function is guaranteed to be the same for a given
2596
+ value only per-process. It may change between different processor
2597
+ architectures or even different versions of GLib. Do not use this
2598
+ function as a basis for building protocols or file formats.
2599
+ </p>
2600
+ <p>
2601
+ The type of <em class="parameter"><code>value</code></em> is <a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer"><span class="type">gconstpointer</span></a> only to allow use of this
2602
+ function with <a class="link" href="glib-Hash-Tables.html#GHashTable" title="GHashTable"><span class="type">GHashTable</span></a>. <em class="parameter"><code>value</code></em> must be a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>.
2603
+ </p>
2604
+ <div class="variablelist"><table border="0">
2605
+ <col align="left" valign="top">
2606
+ <tbody>
2607
+ <tr>
2608
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
2609
+ <td>a basic <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> value as a <a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer"><span class="type">gconstpointer</span></a>
2610
+ </td>
2611
+ </tr>
2612
+ <tr>
2613
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2614
+ <td>a hash value corresponding to <em class="parameter"><code>value</code></em>
2615
+ </td>
2616
+ </tr>
2617
+ </tbody>
2618
+ </table></div>
2619
+ <p class="since">Since 2.24</p>
2620
+ </div>
2621
+ <hr>
2622
+ <div class="refsect2" title="g_variant_equal ()">
2623
+ <a name="g-variant-equal"></a><h3>g_variant_equal ()</h3>
2624
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_variant_equal (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer"><span class="type">gconstpointer</span></a> one</code></em>,
2625
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer"><span class="type">gconstpointer</span></a> two</code></em>);</pre>
2626
+ <p>
2627
+ Checks if <em class="parameter"><code>one</code></em> and <em class="parameter"><code>two</code></em> have the same type and value.
2628
+ </p>
2629
+ <p>
2630
+ The types of <em class="parameter"><code>one</code></em> and <em class="parameter"><code>two</code></em> are <a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer"><span class="type">gconstpointer</span></a> only to allow use of
2631
+ this function with <a class="link" href="glib-Hash-Tables.html#GHashTable" title="GHashTable"><span class="type">GHashTable</span></a>. They must each be a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>.
2632
+ </p>
2633
+ <div class="variablelist"><table border="0">
2634
+ <col align="left" valign="top">
2635
+ <tbody>
2636
+ <tr>
2637
+ <td><p><span class="term"><em class="parameter"><code>one</code></em> :</span></p></td>
2638
+ <td>a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance
2639
+ </td>
2640
+ </tr>
2641
+ <tr>
2642
+ <td><p><span class="term"><em class="parameter"><code>two</code></em> :</span></p></td>
2643
+ <td>a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance
2644
+ </td>
2645
+ </tr>
2646
+ <tr>
2647
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2648
+ <td>
2649
+ <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if <em class="parameter"><code>one</code></em> and <em class="parameter"><code>two</code></em> are equal
2650
+ </td>
2651
+ </tr>
2652
+ </tbody>
2653
+ </table></div>
2654
+ <p class="since">Since 2.24</p>
2655
+ </div>
2656
+ <hr>
2657
+ <div class="refsect2" title="g_variant_print ()">
2658
+ <a name="g-variant-print"></a><h3>g_variant_print ()</h3>
2659
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_variant_print (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>,
2660
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="type">gboolean</span></a> type_annotate</code></em>);</pre>
2661
+ <p>
2662
+ Pretty-prints <em class="parameter"><code>value</code></em> in the format understood by <a class="link" href="glib-GVariant.html#g-variant-parse" title="g_variant_parse ()"><code class="function">g_variant_parse()</code></a>.
2663
+ </p>
2664
+ <p>
2665
+ If <em class="parameter"><code>type_annotate</code></em> is <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a>, then type information is included in
2666
+ the output.
2667
+ </p>
2668
+ <div class="variablelist"><table border="0">
2669
+ <col align="left" valign="top">
2670
+ <tbody>
2671
+ <tr>
2672
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
2673
+ <td>a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>
2674
+ </td>
2675
+ </tr>
2676
+ <tr>
2677
+ <td><p><span class="term"><em class="parameter"><code>type_annotate</code></em> :</span></p></td>
2678
+ <td>
2679
+ <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if type information should be included in
2680
+ the output
2681
+ </td>
2682
+ </tr>
2683
+ <tr>
2684
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2685
+ <td>a newly-allocated string holding the result.
2686
+ </td>
2687
+ </tr>
2688
+ </tbody>
2689
+ </table></div>
2690
+ </div>
2691
+ <hr>
2692
+ <div class="refsect2" title="g_variant_print_string ()">
2693
+ <a name="g-variant-print-string"></a><h3>g_variant_print_string ()</h3>
2694
+ <pre class="programlisting"><a class="link" href="glib-Strings.html#GString" title="GString"><span class="returnvalue">GString</span></a> * g_variant_print_string (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>,
2695
+ <em class="parameter"><code><a class="link" href="glib-Strings.html#GString" title="GString"><span class="type">GString</span></a> *string</code></em>,
2696
+ <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="type">gboolean</span></a> type_annotate</code></em>);</pre>
2697
+ <p>
2698
+ Behaves as <a class="link" href="glib-GVariant.html#g-variant-print" title="g_variant_print ()"><code class="function">g_variant_print()</code></a>, but operates on a <a class="link" href="glib-Strings.html#GString" title="GString"><span class="type">GString</span></a>.
2699
+ </p>
2700
+ <p>
2701
+ If <em class="parameter"><code>string</code></em> is non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> then it is appended to and returned. Else,
2702
+ a new empty <a class="link" href="glib-Strings.html#GString" title="GString"><span class="type">GString</span></a> is allocated and it is returned.
2703
+ </p>
2704
+ <div class="variablelist"><table border="0">
2705
+ <col align="left" valign="top">
2706
+ <tbody>
2707
+ <tr>
2708
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
2709
+ <td>a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>
2710
+ </td>
2711
+ </tr>
2712
+ <tr>
2713
+ <td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
2714
+ <td>a <a class="link" href="glib-Strings.html#GString" title="GString"><span class="type">GString</span></a>, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
2715
+ </td>
2716
+ </tr>
2717
+ <tr>
2718
+ <td><p><span class="term"><em class="parameter"><code>type_annotate</code></em> :</span></p></td>
2719
+ <td>
2720
+ <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if type information should be included in
2721
+ the output
2722
+ </td>
2723
+ </tr>
2724
+ <tr>
2725
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2726
+ <td>a <a class="link" href="glib-Strings.html#GString" title="GString"><span class="type">GString</span></a> containing the string
2727
+ </td>
2728
+ </tr>
2729
+ </tbody>
2730
+ </table></div>
2731
+ <p class="since">Since 2.24</p>
2732
+ </div>
2733
+ <hr>
2734
+ <div class="refsect2" title="GVariantIter">
2735
+ <a name="GVariantIter"></a><h3>GVariantIter</h3>
2736
+ <pre class="programlisting">typedef struct {
2737
+ } GVariantIter;
2738
+ </pre>
2739
+ <p>
2740
+ <a class="link" href="glib-GVariant.html#GVariantIter" title="GVariantIter"><span class="type">GVariantIter</span></a> is an opaque data structure and can only be accessed
2741
+ using the following functions.
2742
+ </p>
2743
+ </div>
2744
+ <hr>
2745
+ <div class="refsect2" title="g_variant_iter_copy ()">
2746
+ <a name="g-variant-iter-copy"></a><h3>g_variant_iter_copy ()</h3>
2747
+ <pre class="programlisting"><a class="link" href="glib-GVariant.html#GVariantIter" title="GVariantIter"><span class="returnvalue">GVariantIter</span></a> * g_variant_iter_copy (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariantIter" title="GVariantIter"><span class="type">GVariantIter</span></a> *iter</code></em>);</pre>
2748
+ <p>
2749
+ Creates a new heap-allocated <a class="link" href="glib-GVariant.html#GVariantIter" title="GVariantIter"><span class="type">GVariantIter</span></a> to iterate over the
2750
+ container that was being iterated over by <em class="parameter"><code>iter</code></em>. Iteration begins on
2751
+ the new iterator from the current position of the old iterator but
2752
+ the two copies are independent past that point.
2753
+ </p>
2754
+ <p>
2755
+ Use <a class="link" href="glib-GVariant.html#g-variant-iter-free" title="g_variant_iter_free ()"><code class="function">g_variant_iter_free()</code></a> to free the return value when you no longer
2756
+ need it.
2757
+ </p>
2758
+ <p>
2759
+ A reference is taken to the container that <em class="parameter"><code>iter</code></em> is iterating over
2760
+ and will be releated only when <a class="link" href="glib-GVariant.html#g-variant-iter-free" title="g_variant_iter_free ()"><code class="function">g_variant_iter_free()</code></a> is called.
2761
+ </p>
2762
+ <div class="variablelist"><table border="0">
2763
+ <col align="left" valign="top">
2764
+ <tbody>
2765
+ <tr>
2766
+ <td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
2767
+ <td>a <a class="link" href="glib-GVariant.html#GVariantIter" title="GVariantIter"><span class="type">GVariantIter</span></a>
2768
+ </td>
2769
+ </tr>
2770
+ <tr>
2771
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2772
+ <td>a new heap-allocated <a class="link" href="glib-GVariant.html#GVariantIter" title="GVariantIter"><span class="type">GVariantIter</span></a>
2773
+ </td>
2774
+ </tr>
2775
+ </tbody>
2776
+ </table></div>
2777
+ <p class="since">Since 2.24</p>
2778
+ </div>
2779
+ <hr>
2780
+ <div class="refsect2" title="g_variant_iter_free ()">
2781
+ <a name="g-variant-iter-free"></a><h3>g_variant_iter_free ()</h3>
2782
+ <pre class="programlisting"><span class="returnvalue">void</span> g_variant_iter_free (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariantIter" title="GVariantIter"><span class="type">GVariantIter</span></a> *iter</code></em>);</pre>
2783
+ <p>
2784
+ Frees a heap-allocated <a class="link" href="glib-GVariant.html#GVariantIter" title="GVariantIter"><span class="type">GVariantIter</span></a>. Only call this function on
2785
+ iterators that were returned by <a class="link" href="glib-GVariant.html#g-variant-iter-new" title="g_variant_iter_new ()"><code class="function">g_variant_iter_new()</code></a> or
2786
+ <a class="link" href="glib-GVariant.html#g-variant-iter-copy" title="g_variant_iter_copy ()"><code class="function">g_variant_iter_copy()</code></a>.
2787
+ </p>
2788
+ <div class="variablelist"><table border="0">
2789
+ <col align="left" valign="top">
2790
+ <tbody><tr>
2791
+ <td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
2792
+ <td>a heap-allocated <a class="link" href="glib-GVariant.html#GVariantIter" title="GVariantIter"><span class="type">GVariantIter</span></a>
2793
+ </td>
2794
+ </tr></tbody>
2795
+ </table></div>
2796
+ <p class="since">Since 2.24</p>
2797
+ </div>
2798
+ <hr>
2799
+ <div class="refsect2" title="g_variant_iter_init ()">
2800
+ <a name="g-variant-iter-init"></a><h3>g_variant_iter_init ()</h3>
2801
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="returnvalue">gsize</span></a> g_variant_iter_init (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariantIter" title="GVariantIter"><span class="type">GVariantIter</span></a> *iter</code></em>,
2802
+ <em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);</pre>
2803
+ <p>
2804
+ Initialises (without allocating) a <a class="link" href="glib-GVariant.html#GVariantIter" title="GVariantIter"><span class="type">GVariantIter</span></a>. <em class="parameter"><code>iter</code></em> may be
2805
+ completely uninitialised prior to this call; its old value is
2806
+ ignored.
2807
+ </p>
2808
+ <p>
2809
+ The iterator remains valid for as long as <em class="parameter"><code>value</code></em> exists, and need not
2810
+ be freed in any way.
2811
+ </p>
2812
+ <div class="variablelist"><table border="0">
2813
+ <col align="left" valign="top">
2814
+ <tbody>
2815
+ <tr>
2816
+ <td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
2817
+ <td>a pointer to a <a class="link" href="glib-GVariant.html#GVariantIter" title="GVariantIter"><span class="type">GVariantIter</span></a>
2818
+ </td>
2819
+ </tr>
2820
+ <tr>
2821
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
2822
+ <td>a container <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>
2823
+ </td>
2824
+ </tr>
2825
+ <tr>
2826
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2827
+ <td>the number of items in <em class="parameter"><code>value</code></em>
2828
+ </td>
2829
+ </tr>
2830
+ </tbody>
2831
+ </table></div>
2832
+ <p class="since">Since 2.24</p>
2833
+ </div>
2834
+ <hr>
2835
+ <div class="refsect2" title="g_variant_iter_n_children ()">
2836
+ <a name="g-variant-iter-n-children"></a><h3>g_variant_iter_n_children ()</h3>
2837
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="returnvalue">gsize</span></a> g_variant_iter_n_children (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariantIter" title="GVariantIter"><span class="type">GVariantIter</span></a> *iter</code></em>);</pre>
2838
+ <p>
2839
+ Queries the number of child items in the container that we are
2840
+ iterating over. This is the total number of items -- not the number
2841
+ of items remaining.
2842
+ </p>
2843
+ <p>
2844
+ This function might be useful for preallocation of arrays.
2845
+ </p>
2846
+ <div class="variablelist"><table border="0">
2847
+ <col align="left" valign="top">
2848
+ <tbody>
2849
+ <tr>
2850
+ <td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
2851
+ <td>a <a class="link" href="glib-GVariant.html#GVariantIter" title="GVariantIter"><span class="type">GVariantIter</span></a>
2852
+ </td>
2853
+ </tr>
2854
+ <tr>
2855
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2856
+ <td>the number of children in the container
2857
+ </td>
2858
+ </tr>
2859
+ </tbody>
2860
+ </table></div>
2861
+ <p class="since">Since 2.24</p>
2862
+ </div>
2863
+ <hr>
2864
+ <div class="refsect2" title="g_variant_iter_new ()">
2865
+ <a name="g-variant-iter-new"></a><h3>g_variant_iter_new ()</h3>
2866
+ <pre class="programlisting"><a class="link" href="glib-GVariant.html#GVariantIter" title="GVariantIter"><span class="returnvalue">GVariantIter</span></a> * g_variant_iter_new (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);</pre>
2867
+ <p>
2868
+ Creates a heap-allocated <a class="link" href="glib-GVariant.html#GVariantIter" title="GVariantIter"><span class="type">GVariantIter</span></a> for iterating over the items
2869
+ in <em class="parameter"><code>value</code></em>.
2870
+ </p>
2871
+ <p>
2872
+ Use <a class="link" href="glib-GVariant.html#g-variant-iter-free" title="g_variant_iter_free ()"><code class="function">g_variant_iter_free()</code></a> to free the return value when you no longer
2873
+ need it.
2874
+ </p>
2875
+ <p>
2876
+ A reference is taken to <em class="parameter"><code>value</code></em> and will be released only when
2877
+ <a class="link" href="glib-GVariant.html#g-variant-iter-free" title="g_variant_iter_free ()"><code class="function">g_variant_iter_free()</code></a> is called.
2878
+ </p>
2879
+ <div class="variablelist"><table border="0">
2880
+ <col align="left" valign="top">
2881
+ <tbody>
2882
+ <tr>
2883
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
2884
+ <td>a container <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>
2885
+ </td>
2886
+ </tr>
2887
+ <tr>
2888
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2889
+ <td>a new heap-allocated <a class="link" href="glib-GVariant.html#GVariantIter" title="GVariantIter"><span class="type">GVariantIter</span></a>
2890
+ </td>
2891
+ </tr>
2892
+ </tbody>
2893
+ </table></div>
2894
+ <p class="since">Since 2.24</p>
2895
+ </div>
2896
+ <hr>
2897
+ <div class="refsect2" title="g_variant_iter_next_value ()">
2898
+ <a name="g-variant-iter-next-value"></a><h3>g_variant_iter_next_value ()</h3>
2899
+ <pre class="programlisting"><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * g_variant_iter_next_value (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariantIter" title="GVariantIter"><span class="type">GVariantIter</span></a> *iter</code></em>);</pre>
2900
+ <p>
2901
+ Gets the next item in the container. If no more items remain then
2902
+ <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> is returned.
2903
+ </p>
2904
+ <p>
2905
+ Use <a class="link" href="glib-GVariant.html#g-variant-unref" title="g_variant_unref ()"><code class="function">g_variant_unref()</code></a> to drop your reference on the return value when
2906
+ you no longer need it.
2907
+ </p>
2908
+ <p>
2909
+ </p>
2910
+ <div class="example">
2911
+ <a name="id933696"></a><p class="title"><b>Example 23. Iterating with <a class="link" href="glib-GVariant.html#g-variant-iter-next-value" title="g_variant_iter_next_value ()"><code class="function">g_variant_iter_next_value()</code></a></b></p>
2912
+ <div class="example-contents">
2913
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
2914
+ <tbody>
2915
+ <tr>
2916
+ <td class="listing_lines" align="right"><pre>1
2917
+ 2
2918
+ 3
2919
+ 4
2920
+ 5
2921
+ 6
2922
+ 7
2923
+ 8
2924
+ 9
2925
+ 10
2926
+ 11
2927
+ 12
2928
+ 13
2929
+ 14
2930
+ 15
2931
+ 16
2932
+ 17
2933
+ 18</pre></td>
2934
+ <td class="listing_code"><pre class="programlisting"><span class="comment">/* recursively iterate a container */</span>
2935
+ <span class="type">void</span>
2936
+ <span class="function">iterate_container_recursive</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GVariant</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">container</span><span class="symbol">)</span>
2937
+ <span class="cbracket">{</span>
2938
+ <span class="normal"> </span><span class="usertype">GVariantIter</span><span class="normal"> iter</span><span class="symbol">;</span>
2939
+ <span class="normal"> </span><span class="usertype">GVariant</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">child</span><span class="symbol">;</span>
2940
+
2941
+ <span class="normal"> </span><span class="function"><a href="glib-GVariant.html#g-variant-iter-init">g_variant_iter_init</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">iter</span><span class="symbol">,</span><span class="normal"> dictionary</span><span class="symbol">);</span>
2942
+ <span class="normal"> </span><span class="keyword">while</span><span class="normal"> </span><span class="symbol">((</span><span class="normal">child </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-GVariant.html#g-variant-iter-next-value">g_variant_iter_next_value</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">iter</span><span class="symbol">)))</span>
2943
+ <span class="normal"> </span><span class="cbracket">{</span>
2944
+ <span class="normal"> </span><span class="function"><a href="glib-Warnings-and-Assertions.html#g-print">g_print</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"type '%s'</span><span class="specialchar">\n</span><span class="string">"</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="glib-GVariant.html#g-variant-get-type-string">g_variant_get_type_string</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">child</span><span class="symbol">));</span>
2945
+
2946
+ <span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="glib-GVariant.html#g-variant-is-container">g_variant_is_container</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">child</span><span class="symbol">))</span>
2947
+ <span class="normal"> </span><span class="function">iterate_container_recursive</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">child</span><span class="symbol">);</span>
2948
+
2949
+ <span class="normal"> </span><span class="function"><a href="glib-GVariant.html#g-variant-unref">g_variant_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">child</span><span class="symbol">);</span>
2950
+ <span class="normal"> </span><span class="cbracket">}</span>
2951
+ <span class="cbracket">}</span></pre></td>
2952
+ </tr>
2953
+ </tbody>
2954
+ </table>
2955
+ </div>
2956
+
2957
+ </div>
2958
+ <p><br class="example-break">
2959
+ </p>
2960
+ <div class="variablelist"><table border="0">
2961
+ <col align="left" valign="top">
2962
+ <tbody>
2963
+ <tr>
2964
+ <td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
2965
+ <td>a <a class="link" href="glib-GVariant.html#GVariantIter" title="GVariantIter"><span class="type">GVariantIter</span></a>
2966
+ </td>
2967
+ </tr>
2968
+ <tr>
2969
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2970
+ <td>a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
2971
+ </td>
2972
+ </tr>
2973
+ </tbody>
2974
+ </table></div>
2975
+ <p class="since">Since 2.24</p>
2976
+ </div>
2977
+ <hr>
2978
+ <div class="refsect2" title="g_variant_iter_next ()">
2979
+ <a name="g-variant-iter-next"></a><h3>g_variant_iter_next ()</h3>
2980
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_variant_iter_next (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariantIter" title="GVariantIter"><span class="type">GVariantIter</span></a> *iter</code></em>,
2981
+ <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *format_string</code></em>,
2982
+ <em class="parameter"><code>...</code></em>);</pre>
2983
+ <p>
2984
+ Gets the next item in the container and unpacks it into the variable
2985
+ argument list according to <em class="parameter"><code>format_string</code></em>, returning <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a>.
2986
+ </p>
2987
+ <p>
2988
+ If no more items remain then <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> is returned.
2989
+ </p>
2990
+ <p>
2991
+ All of the pointers given on the variable arguments list of this
2992
+ function are assumed to point at uninitialised memory. It is the
2993
+ responsibility of the caller to free all of the values returned by
2994
+ the unpacking process.
2995
+ </p>
2996
+ <p>
2997
+ </p>
2998
+ <div class="example">
2999
+ <a name="id933912"></a><p class="title"><b>Example 24. Memory management with <a class="link" href="glib-GVariant.html#g-variant-iter-next" title="g_variant_iter_next ()"><code class="function">g_variant_iter_next()</code></a></b></p>
3000
+ <div class="example-contents">
3001
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
3002
+ <tbody>
3003
+ <tr>
3004
+ <td class="listing_lines" align="right"><pre>1
3005
+ 2
3006
+ 3
3007
+ 4
3008
+ 5
3009
+ 6
3010
+ 7
3011
+ 8
3012
+ 9
3013
+ 10
3014
+ 11
3015
+ 12
3016
+ 13
3017
+ 14
3018
+ 15
3019
+ 16
3020
+ 17
3021
+ 18
3022
+ 19</pre></td>
3023
+ <td class="listing_code"><pre class="programlisting"><span class="comment">/* Iterates a dictionary of type 'a{sv}' */</span>
3024
+ <span class="type">void</span>
3025
+ <span class="function">iterate_dictionary</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GVariant</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">dictionary</span><span class="symbol">)</span>
3026
+ <span class="cbracket">{</span>
3027
+ <span class="normal"> </span><span class="usertype">GVariantIter</span><span class="normal"> iter</span><span class="symbol">;</span>
3028
+ <span class="normal"> </span><span class="usertype">GVariant</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">value</span><span class="symbol">;</span>
3029
+ <span class="normal"> </span><span class="usertype">gchar</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">key</span><span class="symbol">;</span>
3030
+
3031
+ <span class="normal"> </span><span class="function"><a href="glib-GVariant.html#g-variant-iter-init">g_variant_iter_init</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">iter</span><span class="symbol">,</span><span class="normal"> dictionary</span><span class="symbol">);</span>
3032
+ <span class="normal"> </span><span class="keyword">while</span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="glib-GVariant.html#g-variant-iter-next">g_variant_iter_next</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">iter</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"{sv}"</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">key</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">value</span><span class="symbol">))</span>
3033
+ <span class="normal"> </span><span class="cbracket">{</span>
3034
+ <span class="normal"> </span><span class="function"><a href="glib-Warnings-and-Assertions.html#g-print">g_print</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"Item '%s' has type '%s'</span><span class="specialchar">\n</span><span class="string">"</span><span class="symbol">,</span><span class="normal"> key</span><span class="symbol">,</span>
3035
+ <span class="normal"> </span><span class="function"><a href="glib-GVariant.html#g-variant-get-type-string">g_variant_get_type_string</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">value</span><span class="symbol">));</span>
3036
+
3037
+ <span class="normal"> </span><span class="comment">/* must free data for ourselves */</span>
3038
+ <span class="normal"> </span><span class="function"><a href="glib-GVariant.html#g-variant-unref">g_variant_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">value</span><span class="symbol">);</span>
3039
+ <span class="normal"> </span><span class="function"><a href="glib-Memory-Allocation.html#g-free">g_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">key</span><span class="symbol">);</span>
3040
+ <span class="normal"> </span><span class="cbracket">}</span>
3041
+ <span class="cbracket">}</span></pre></td>
3042
+ </tr>
3043
+ </tbody>
3044
+ </table>
3045
+ </div>
3046
+
3047
+ </div>
3048
+ <p><br class="example-break">
3049
+ </p>
3050
+ <p>
3051
+ For a solution that is likely to be more convenient to C programmers
3052
+ when dealing with loops, see <a class="link" href="glib-GVariant.html#g-variant-iter-loop" title="g_variant_iter_loop ()"><code class="function">g_variant_iter_loop()</code></a>.
3053
+ </p>
3054
+ <div class="variablelist"><table border="0">
3055
+ <col align="left" valign="top">
3056
+ <tbody>
3057
+ <tr>
3058
+ <td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
3059
+ <td>a <a class="link" href="glib-GVariant.html#GVariantIter" title="GVariantIter"><span class="type">GVariantIter</span></a>
3060
+ </td>
3061
+ </tr>
3062
+ <tr>
3063
+ <td><p><span class="term"><em class="parameter"><code>format_string</code></em> :</span></p></td>
3064
+ <td>a GVariant format string
3065
+ </td>
3066
+ </tr>
3067
+ <tr>
3068
+ <td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
3069
+ <td>the arguments to unpack the value into
3070
+ </td>
3071
+ </tr>
3072
+ <tr>
3073
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3074
+ <td>
3075
+ <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if a value was unpacked, or <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> if there as no
3076
+ value
3077
+ </td>
3078
+ </tr>
3079
+ </tbody>
3080
+ </table></div>
3081
+ <p class="since">Since 2.24</p>
3082
+ </div>
3083
+ <hr>
3084
+ <div class="refsect2" title="g_variant_iter_loop ()">
3085
+ <a name="g-variant-iter-loop"></a><h3>g_variant_iter_loop ()</h3>
3086
+ <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_variant_iter_loop (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariantIter" title="GVariantIter"><span class="type">GVariantIter</span></a> *iter</code></em>,
3087
+ <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *format_string</code></em>,
3088
+ <em class="parameter"><code>...</code></em>);</pre>
3089
+ <p>
3090
+ Gets the next item in the container and unpacks it into the variable
3091
+ argument list according to <em class="parameter"><code>format_string</code></em>, returning <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a>.
3092
+ </p>
3093
+ <p>
3094
+ If no more items remain then <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> is returned.
3095
+ </p>
3096
+ <p>
3097
+ On the first call to this function, the pointers appearing on the
3098
+ variable argument list are assumed to point at uninitialised memory.
3099
+ On the second and later calls, it is assumed that the same pointers
3100
+ will be given and that they will point to the memory as set by the
3101
+ previous call to this function. This allows the previous values to
3102
+ be freed, as appropriate.
3103
+ </p>
3104
+ <p>
3105
+ This function is intended to be used with a while loop as
3106
+ demonstrated in the following example. This function can only be
3107
+ used when iterating over an array. It is only valid to call this
3108
+ function with a string constant for the format string and the same
3109
+ string constant must be used each time. Mixing calls to this
3110
+ function and <a class="link" href="glib-GVariant.html#g-variant-iter-next" title="g_variant_iter_next ()"><code class="function">g_variant_iter_next()</code></a> or <a class="link" href="glib-GVariant.html#g-variant-iter-next-value" title="g_variant_iter_next_value ()"><code class="function">g_variant_iter_next_value()</code></a> on
3111
+ the same iterator is not recommended.
3112
+ </p>
3113
+ <p>
3114
+ </p>
3115
+ <div class="example">
3116
+ <a name="id934211"></a><p class="title"><b>Example 25. Memory management with <a class="link" href="glib-GVariant.html#g-variant-iter-loop" title="g_variant_iter_loop ()"><code class="function">g_variant_iter_loop()</code></a></b></p>
3117
+ <div class="example-contents">
3118
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
3119
+ <tbody>
3120
+ <tr>
3121
+ <td class="listing_lines" align="right"><pre>1
3122
+ 2
3123
+ 3
3124
+ 4
3125
+ 5
3126
+ 6
3127
+ 7
3128
+ 8
3129
+ 9
3130
+ 10
3131
+ 11
3132
+ 12
3133
+ 13
3134
+ 14
3135
+ 15
3136
+ 16
3137
+ 17</pre></td>
3138
+ <td class="listing_code"><pre class="programlisting"><span class="comment">/* Iterates a dictionary of type 'a{sv}' */</span>
3139
+ <span class="type">void</span>
3140
+ <span class="function">iterate_dictionary</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GVariant</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">dictionary</span><span class="symbol">)</span>
3141
+ <span class="cbracket">{</span>
3142
+ <span class="normal"> </span><span class="usertype">GVariantIter</span><span class="normal"> iter</span><span class="symbol">;</span>
3143
+ <span class="normal"> </span><span class="usertype">GVariant</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">value</span><span class="symbol">;</span>
3144
+ <span class="normal"> </span><span class="usertype">gchar</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">key</span><span class="symbol">;</span>
3145
+
3146
+ <span class="normal"> </span><span class="function"><a href="glib-GVariant.html#g-variant-iter-init">g_variant_iter_init</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">iter</span><span class="symbol">,</span><span class="normal"> dictionary</span><span class="symbol">);</span>
3147
+ <span class="normal"> </span><span class="keyword">while</span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="glib-GVariant.html#g-variant-iter-loop">g_variant_iter_loop</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">iter</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"{sv}"</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">key</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">value</span><span class="symbol">))</span>
3148
+ <span class="normal"> </span><span class="cbracket">{</span>
3149
+ <span class="normal"> </span><span class="function"><a href="glib-Warnings-and-Assertions.html#g-print">g_print</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"Item '%s' has type '%s'</span><span class="specialchar">\n</span><span class="string">"</span><span class="symbol">,</span><span class="normal"> key</span><span class="symbol">,</span>
3150
+ <span class="normal"> </span><span class="function"><a href="glib-GVariant.html#g-variant-get-type-string">g_variant_get_type_string</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">value</span><span class="symbol">));</span>
3151
+
3152
+ <span class="normal"> </span><span class="comment">/* no need to free 'key' and 'value' here */</span>
3153
+ <span class="normal"> </span><span class="cbracket">}</span>
3154
+ <span class="cbracket">}</span></pre></td>
3155
+ </tr>
3156
+ </tbody>
3157
+ </table>
3158
+ </div>
3159
+
3160
+ </div>
3161
+ <p><br class="example-break">
3162
+ </p>
3163
+ <p>
3164
+ If you want a slightly less magical alternative that requires more
3165
+ typing, see <a class="link" href="glib-GVariant.html#g-variant-iter-next" title="g_variant_iter_next ()"><code class="function">g_variant_iter_next()</code></a>.
3166
+ </p>
3167
+ <div class="variablelist"><table border="0">
3168
+ <col align="left" valign="top">
3169
+ <tbody>
3170
+ <tr>
3171
+ <td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
3172
+ <td>a <a class="link" href="glib-GVariant.html#GVariantIter" title="GVariantIter"><span class="type">GVariantIter</span></a>
3173
+ </td>
3174
+ </tr>
3175
+ <tr>
3176
+ <td><p><span class="term"><em class="parameter"><code>format_string</code></em> :</span></p></td>
3177
+ <td>a GVariant format string
3178
+ </td>
3179
+ </tr>
3180
+ <tr>
3181
+ <td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
3182
+ <td>the arguments to unpack the value into
3183
+ </td>
3184
+ </tr>
3185
+ <tr>
3186
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3187
+ <td>
3188
+ <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if a value was unpacked, or <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> if there as no
3189
+ value
3190
+ </td>
3191
+ </tr>
3192
+ </tbody>
3193
+ </table></div>
3194
+ <p class="since">Since 2.24</p>
3195
+ </div>
3196
+ <hr>
3197
+ <div class="refsect2" title="GVariantBuilder">
3198
+ <a name="GVariantBuilder"></a><h3>GVariantBuilder</h3>
3199
+ <pre class="programlisting">typedef struct {
3200
+ } GVariantBuilder;
3201
+ </pre>
3202
+ <p>
3203
+ A utility type for constructing container-type <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instances.
3204
+ </p>
3205
+ <p>
3206
+ This is an opaque structure and may only be accessed using the
3207
+ following functions.
3208
+ </p>
3209
+ <p>
3210
+ <a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a> is not threadsafe in any way. Do not attempt to
3211
+ access it from more than one thread.
3212
+ </p>
3213
+ </div>
3214
+ <hr>
3215
+ <div class="refsect2" title="g_variant_builder_unref ()">
3216
+ <a name="g-variant-builder-unref"></a><h3>g_variant_builder_unref ()</h3>
3217
+ <pre class="programlisting"><span class="returnvalue">void</span> g_variant_builder_unref (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a> *builder</code></em>);</pre>
3218
+ <p>
3219
+ Decreases the reference count on <em class="parameter"><code>builder</code></em>.
3220
+ </p>
3221
+ <p>
3222
+ In the event that there are no more references, releases all memory
3223
+ associated with the <a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a>.
3224
+ </p>
3225
+ <p>
3226
+ Don't call this on stack-allocated <a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a> instances or bad
3227
+ things will happen.
3228
+ </p>
3229
+ <div class="variablelist"><table border="0">
3230
+ <col align="left" valign="top">
3231
+ <tbody><tr>
3232
+ <td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
3233
+ <td>a <a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a> allocated by <a class="link" href="glib-GVariant.html#g-variant-builder-new" title="g_variant_builder_new ()"><code class="function">g_variant_builder_new()</code></a>
3234
+ </td>
3235
+ </tr></tbody>
3236
+ </table></div>
3237
+ <p class="since">Since 2.24</p>
3238
+ </div>
3239
+ <hr>
3240
+ <div class="refsect2" title="g_variant_builder_ref ()">
3241
+ <a name="g-variant-builder-ref"></a><h3>g_variant_builder_ref ()</h3>
3242
+ <pre class="programlisting"><a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="returnvalue">GVariantBuilder</span></a> * g_variant_builder_ref (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a> *builder</code></em>);</pre>
3243
+ <p>
3244
+ Increases the reference count on <em class="parameter"><code>builder</code></em>.
3245
+ </p>
3246
+ <p>
3247
+ Don't call this on stack-allocated <a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a> instances or bad
3248
+ things will happen.
3249
+ </p>
3250
+ <div class="variablelist"><table border="0">
3251
+ <col align="left" valign="top">
3252
+ <tbody>
3253
+ <tr>
3254
+ <td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
3255
+ <td>a <a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a> allocated by <a class="link" href="glib-GVariant.html#g-variant-builder-new" title="g_variant_builder_new ()"><code class="function">g_variant_builder_new()</code></a>
3256
+ </td>
3257
+ </tr>
3258
+ <tr>
3259
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3260
+ <td>a new reference to <em class="parameter"><code>builder</code></em>
3261
+ </td>
3262
+ </tr>
3263
+ </tbody>
3264
+ </table></div>
3265
+ <p class="since">Since 2.24</p>
3266
+ </div>
3267
+ <hr>
3268
+ <div class="refsect2" title="g_variant_builder_new ()">
3269
+ <a name="g-variant-builder-new"></a><h3>g_variant_builder_new ()</h3>
3270
+ <pre class="programlisting"><a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="returnvalue">GVariantBuilder</span></a> * g_variant_builder_new (<em class="parameter"><code>const <a class="link" href="glib-GVariantType.html#GVariantType" title="GVariantType"><span class="type">GVariantType</span></a> *type</code></em>);</pre>
3271
+ <p>
3272
+ Allocates and initialises a new <a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a>.
3273
+ </p>
3274
+ <p>
3275
+ You should call <a class="link" href="glib-GVariant.html#g-variant-builder-unref" title="g_variant_builder_unref ()"><code class="function">g_variant_builder_unref()</code></a> on the return value when it
3276
+ is no longer needed. The memory will not be automatically freed by
3277
+ any other call.
3278
+ </p>
3279
+ <p>
3280
+ In most cases it is easier to place a <a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a> directly on
3281
+ the stack of the calling function and initialise it with
3282
+ <a class="link" href="glib-GVariant.html#g-variant-builder-init" title="g_variant_builder_init ()"><code class="function">g_variant_builder_init()</code></a>.
3283
+ </p>
3284
+ <div class="variablelist"><table border="0">
3285
+ <col align="left" valign="top">
3286
+ <tbody>
3287
+ <tr>
3288
+ <td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
3289
+ <td>a container type
3290
+ </td>
3291
+ </tr>
3292
+ <tr>
3293
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3294
+ <td>a <a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a>
3295
+ </td>
3296
+ </tr>
3297
+ </tbody>
3298
+ </table></div>
3299
+ <p class="since">Since 2.24</p>
3300
+ </div>
3301
+ <hr>
3302
+ <div class="refsect2" title="g_variant_builder_init ()">
3303
+ <a name="g-variant-builder-init"></a><h3>g_variant_builder_init ()</h3>
3304
+ <pre class="programlisting"><span class="returnvalue">void</span> g_variant_builder_init (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a> *builder</code></em>,
3305
+ <em class="parameter"><code>const <a class="link" href="glib-GVariantType.html#GVariantType" title="GVariantType"><span class="type">GVariantType</span></a> *type</code></em>);</pre>
3306
+ <p>
3307
+ Initialises a <a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a> structure.
3308
+ </p>
3309
+ <p>
3310
+ <em class="parameter"><code>type</code></em> must be non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. It specifies the type of container to
3311
+ construct. It can be an indefinite type such as
3312
+ <a class="link" href="glib-GVariantType.html#G-VARIANT-TYPE-ARRAY:CAPS" title="G_VARIANT_TYPE_ARRAY"><code class="literal">G_VARIANT_TYPE_ARRAY</code></a> or a definite type such as "as" or "(ii)".
3313
+ Maybe, array, tuple, dictionary entry and variant-typed values may be
3314
+ constructed.
3315
+ </p>
3316
+ <p>
3317
+ After the builder is initialised, values are added using
3318
+ <a class="link" href="glib-GVariant.html#g-variant-builder-add-value" title="g_variant_builder_add_value ()"><code class="function">g_variant_builder_add_value()</code></a> or <a class="link" href="glib-GVariant.html#g-variant-builder-add" title="g_variant_builder_add ()"><code class="function">g_variant_builder_add()</code></a>.
3319
+ </p>
3320
+ <p>
3321
+ After all the child values are added, <a class="link" href="glib-GVariant.html#g-variant-builder-end" title="g_variant_builder_end ()"><code class="function">g_variant_builder_end()</code></a> frees
3322
+ the memory associated with the builder and returns the <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> that
3323
+ was created.
3324
+ </p>
3325
+ <p>
3326
+ This function completely ignores the previous contents of <em class="parameter"><code>builder</code></em>.
3327
+ On one hand this means that it is valid to pass in completely
3328
+ uninitialised memory. On the other hand, this means that if you are
3329
+ initialising over top of an existing <a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a> you need to
3330
+ first call <a class="link" href="glib-GVariant.html#g-variant-builder-clear" title="g_variant_builder_clear ()"><code class="function">g_variant_builder_clear()</code></a> in order to avoid leaking
3331
+ memory.
3332
+ </p>
3333
+ <p>
3334
+ You must not call <a class="link" href="glib-GVariant.html#g-variant-builder-ref" title="g_variant_builder_ref ()"><code class="function">g_variant_builder_ref()</code></a> or
3335
+ <a class="link" href="glib-GVariant.html#g-variant-builder-unref" title="g_variant_builder_unref ()"><code class="function">g_variant_builder_unref()</code></a> on a <a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a> that was initialised
3336
+ with this function. If you ever pass a reference to a
3337
+ <a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a> outside of the control of your own code then you
3338
+ should assume that the person receiving that reference may try to use
3339
+ reference counting; you should use <a class="link" href="glib-GVariant.html#g-variant-builder-new" title="g_variant_builder_new ()"><code class="function">g_variant_builder_new()</code></a> instead of
3340
+ this function.
3341
+ </p>
3342
+ <div class="variablelist"><table border="0">
3343
+ <col align="left" valign="top">
3344
+ <tbody>
3345
+ <tr>
3346
+ <td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
3347
+ <td>a <a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a>
3348
+ </td>
3349
+ </tr>
3350
+ <tr>
3351
+ <td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
3352
+ <td>a container type
3353
+ </td>
3354
+ </tr>
3355
+ </tbody>
3356
+ </table></div>
3357
+ <p class="since">Since 2.24</p>
3358
+ </div>
3359
+ <hr>
3360
+ <div class="refsect2" title="g_variant_builder_clear ()">
3361
+ <a name="g-variant-builder-clear"></a><h3>g_variant_builder_clear ()</h3>
3362
+ <pre class="programlisting"><span class="returnvalue">void</span> g_variant_builder_clear (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a> *builder</code></em>);</pre>
3363
+ <p>
3364
+ Releases all memory associated with a <a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a> without
3365
+ freeing the <a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a> structure itself.
3366
+ </p>
3367
+ <p>
3368
+ It typically only makes sense to do this on a stack-allocated
3369
+ <a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a> if you want to abort building the value part-way
3370
+ through. This function need not be called if you call
3371
+ <a class="link" href="glib-GVariant.html#g-variant-builder-end" title="g_variant_builder_end ()"><code class="function">g_variant_builder_end()</code></a> and it also doesn't need to be called on
3372
+ builders allocated with g_variant_builder_new (see
3373
+ <code class="function">g_variant_builder_free()</code> for that).
3374
+ </p>
3375
+ <p>
3376
+ This function leaves the <a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a> structure set to all-zeros.
3377
+ It is valid to call this function on either an initialised
3378
+ <a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a> or one that is set to all-zeros but it is not valid
3379
+ to call this function on uninitialised memory.
3380
+ </p>
3381
+ <div class="variablelist"><table border="0">
3382
+ <col align="left" valign="top">
3383
+ <tbody><tr>
3384
+ <td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
3385
+ <td>a <a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a>
3386
+ </td>
3387
+ </tr></tbody>
3388
+ </table></div>
3389
+ <p class="since">Since 2.24</p>
3390
+ </div>
3391
+ <hr>
3392
+ <div class="refsect2" title="g_variant_builder_add_value ()">
3393
+ <a name="g-variant-builder-add-value"></a><h3>g_variant_builder_add_value ()</h3>
3394
+ <pre class="programlisting"><span class="returnvalue">void</span> g_variant_builder_add_value (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a> *builder</code></em>,
3395
+ <em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> *value</code></em>);</pre>
3396
+ <p>
3397
+ Adds <em class="parameter"><code>value</code></em> to <em class="parameter"><code>builder</code></em>.
3398
+ </p>
3399
+ <p>
3400
+ It is an error to call this function in any way that would create an
3401
+ inconsistent value to be constructed. Some examples of this are
3402
+ putting different types of items into an array, putting the wrong
3403
+ types or number of items in a tuple, putting more than one value into
3404
+ a variant, etc.
3405
+ </p>
3406
+ <div class="variablelist"><table border="0">
3407
+ <col align="left" valign="top">
3408
+ <tbody>
3409
+ <tr>
3410
+ <td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
3411
+ <td>a <a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a>
3412
+ </td>
3413
+ </tr>
3414
+ <tr>
3415
+ <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
3416
+ <td>a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>
3417
+ </td>
3418
+ </tr>
3419
+ </tbody>
3420
+ </table></div>
3421
+ <p class="since">Since 2.24</p>
3422
+ </div>
3423
+ <hr>
3424
+ <div class="refsect2" title="g_variant_builder_add ()">
3425
+ <a name="g-variant-builder-add"></a><h3>g_variant_builder_add ()</h3>
3426
+ <pre class="programlisting"><span class="returnvalue">void</span> g_variant_builder_add (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a> *builder</code></em>,
3427
+ <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *format_string</code></em>,
3428
+ <em class="parameter"><code>...</code></em>);</pre>
3429
+ <p>
3430
+ Adds to a <a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a>.
3431
+ </p>
3432
+ <p>
3433
+ This call is a convenience wrapper that is exactly equivalent to
3434
+ calling <a class="link" href="glib-GVariant.html#g-variant-new" title="g_variant_new ()"><code class="function">g_variant_new()</code></a> followed by <a class="link" href="glib-GVariant.html#g-variant-builder-add-value" title="g_variant_builder_add_value ()"><code class="function">g_variant_builder_add_value()</code></a>.
3435
+ </p>
3436
+ <p>
3437
+ This function might be used as follows:
3438
+ </p>
3439
+ <p>
3440
+ </p>
3441
+ <pre class="programlisting">
3442
+ GVariant *
3443
+ make_pointless_dictionary (void)
3444
+ {
3445
+ GVariantBuilder *builder;
3446
+ int i;
3447
+
3448
+ builder = g_variant_builder_new (G_VARIANT_TYPE_CLASS_ARRAY,
3449
+ NULL);
3450
+ for (i = 0; i &lt; 16; i++)
3451
+ {
3452
+ gchar buf[3];
3453
+
3454
+ sprintf (buf, "%d", i);
3455
+ g_variant_builder_add (builder, "{is}", i, buf);
3456
+ }
3457
+
3458
+ return g_variant_builder_end (builder);
3459
+ }
3460
+ </pre>
3461
+ <p>
3462
+ </p>
3463
+ <div class="variablelist"><table border="0">
3464
+ <col align="left" valign="top">
3465
+ <tbody>
3466
+ <tr>
3467
+ <td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
3468
+ <td>a <a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a>
3469
+ </td>
3470
+ </tr>
3471
+ <tr>
3472
+ <td><p><span class="term"><em class="parameter"><code>format_string</code></em> :</span></p></td>
3473
+ <td>a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> varargs format string
3474
+ </td>
3475
+ </tr>
3476
+ <tr>
3477
+ <td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
3478
+ <td>arguments, as per <em class="parameter"><code>format_string</code></em>
3479
+ </td>
3480
+ </tr>
3481
+ </tbody>
3482
+ </table></div>
3483
+ <p class="since">Since 2.24</p>
3484
+ </div>
3485
+ <hr>
3486
+ <div class="refsect2" title="g_variant_builder_end ()">
3487
+ <a name="g-variant-builder-end"></a><h3>g_variant_builder_end ()</h3>
3488
+ <pre class="programlisting"><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * g_variant_builder_end (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a> *builder</code></em>);</pre>
3489
+ <p>
3490
+ Ends the builder process and returns the constructed value.
3491
+ </p>
3492
+ <p>
3493
+ It is not permissible to use <em class="parameter"><code>builder</code></em> in any way after this call
3494
+ except for reference counting operations (in the case of a
3495
+ heap-allocated <a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a>) or by reinitialising it with
3496
+ <a class="link" href="glib-GVariant.html#g-variant-builder-init" title="g_variant_builder_init ()"><code class="function">g_variant_builder_init()</code></a> (in the case of stack-allocated).
3497
+ </p>
3498
+ <p>
3499
+ It is an error to call this function in any way that would create an
3500
+ inconsistent value to be constructed (ie: insufficient number of
3501
+ items added to a container with a specific number of children
3502
+ required). It is also an error to call this function if the builder
3503
+ was created with an indefinite array or maybe type and no children
3504
+ have been added; in this case it is impossible to infer the type of
3505
+ the empty array.
3506
+ </p>
3507
+ <div class="variablelist"><table border="0">
3508
+ <col align="left" valign="top">
3509
+ <tbody>
3510
+ <tr>
3511
+ <td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
3512
+ <td>a <a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a>
3513
+ </td>
3514
+ </tr>
3515
+ <tr>
3516
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3517
+ <td>a new, floating, <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>
3518
+ </td>
3519
+ </tr>
3520
+ </tbody>
3521
+ </table></div>
3522
+ <p class="since">Since 2.24</p>
3523
+ </div>
3524
+ <hr>
3525
+ <div class="refsect2" title="g_variant_builder_open ()">
3526
+ <a name="g-variant-builder-open"></a><h3>g_variant_builder_open ()</h3>
3527
+ <pre class="programlisting"><span class="returnvalue">void</span> g_variant_builder_open (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a> *builder</code></em>,
3528
+ <em class="parameter"><code>const <a class="link" href="glib-GVariantType.html#GVariantType" title="GVariantType"><span class="type">GVariantType</span></a> *type</code></em>);</pre>
3529
+ <p>
3530
+ Opens a subcontainer inside the given <em class="parameter"><code>builder</code></em>. When done adding
3531
+ items to the subcontainer, <a class="link" href="glib-GVariant.html#g-variant-builder-close" title="g_variant_builder_close ()"><code class="function">g_variant_builder_close()</code></a> must be called.
3532
+ </p>
3533
+ <p>
3534
+ It is an error to call this function in any way that would cause an
3535
+ inconsistent value to be constructed (ie: adding too many values or
3536
+ a value of an incorrect type).
3537
+ </p>
3538
+ <div class="variablelist"><table border="0">
3539
+ <col align="left" valign="top">
3540
+ <tbody>
3541
+ <tr>
3542
+ <td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
3543
+ <td>a <a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a>
3544
+ </td>
3545
+ </tr>
3546
+ <tr>
3547
+ <td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
3548
+ <td>a <a class="link" href="glib-GVariantType.html#GVariantType" title="GVariantType"><span class="type">GVariantType</span></a>
3549
+ </td>
3550
+ </tr>
3551
+ </tbody>
3552
+ </table></div>
3553
+ <p class="since">Since 2.24</p>
3554
+ </div>
3555
+ <hr>
3556
+ <div class="refsect2" title="g_variant_builder_close ()">
3557
+ <a name="g-variant-builder-close"></a><h3>g_variant_builder_close ()</h3>
3558
+ <pre class="programlisting"><span class="returnvalue">void</span> g_variant_builder_close (<em class="parameter"><code><a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a> *builder</code></em>);</pre>
3559
+ <p>
3560
+ Closes the subcontainer inside the given <em class="parameter"><code>builder</code></em> that was opened by
3561
+ the most recent call to <a class="link" href="glib-GVariant.html#g-variant-builder-open" title="g_variant_builder_open ()"><code class="function">g_variant_builder_open()</code></a>.
3562
+ </p>
3563
+ <p>
3564
+ It is an error to call this function in any way that would create an
3565
+ inconsistent value to be constructed (ie: too few values added to the
3566
+ subcontainer).
3567
+ </p>
3568
+ <div class="variablelist"><table border="0">
3569
+ <col align="left" valign="top">
3570
+ <tbody><tr>
3571
+ <td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
3572
+ <td>a <a class="link" href="glib-GVariant.html#GVariantBuilder" title="GVariantBuilder"><span class="type">GVariantBuilder</span></a>
3573
+ </td>
3574
+ </tr></tbody>
3575
+ </table></div>
3576
+ <p class="since">Since 2.24</p>
3577
+ </div>
3578
+ <hr>
3579
+ <div class="refsect2" title="G_VARIANT_PARSE_ERROR">
3580
+ <a name="G-VARIANT-PARSE-ERROR:CAPS"></a><h3>G_VARIANT_PARSE_ERROR</h3>
3581
+ <pre class="programlisting">#define G_VARIANT_PARSE_ERROR (g_variant_parser_get_error_quark ())
3582
+ </pre>
3583
+ <p>
3584
+ Error domain for GVariant text format parsing. Specific error codes
3585
+ are not currently defined for this domain. See <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> for
3586
+ information on error domains.
3587
+ </p>
3588
+ </div>
3589
+ <hr>
3590
+ <div class="refsect2" title="g_variant_parse ()">
3591
+ <a name="g-variant-parse"></a><h3>g_variant_parse ()</h3>
3592
+ <pre class="programlisting"><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * g_variant_parse (<em class="parameter"><code>const <a class="link" href="glib-GVariantType.html#GVariantType" title="GVariantType"><span class="type">GVariantType</span></a> *type</code></em>,
3593
+ <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *text</code></em>,
3594
+ <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *limit</code></em>,
3595
+ <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **endptr</code></em>,
3596
+ <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>
3597
+ <p>
3598
+ Parses a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> from a text representation.
3599
+ </p>
3600
+ <p>
3601
+ A single <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> is parsed from the content of <em class="parameter"><code>text</code></em>.
3602
+ </p>
3603
+ <p>
3604
+ The memory at <em class="parameter"><code>limit</code></em> will never be accessed and the parser behaves as
3605
+ if the character at <em class="parameter"><code>limit</code></em> is the nul terminator. This has the
3606
+ effect of bounding <em class="parameter"><code>text</code></em>.
3607
+ </p>
3608
+ <p>
3609
+ If <em class="parameter"><code>endptr</code></em> is non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> then <em class="parameter"><code>text</code></em> is permitted to contain data
3610
+ following the value that this function parses and <em class="parameter"><code>endptr</code></em> will be
3611
+ updated to point to the first character past the end of the text
3612
+ parsed by this function. If <em class="parameter"><code>endptr</code></em> is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> and there is extra data
3613
+ then an error is returned.
3614
+ </p>
3615
+ <p>
3616
+ If <em class="parameter"><code>type</code></em> is non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> then the value will be parsed to have that
3617
+ type. This may result in additional parse errors (in the case that
3618
+ the parsed value doesn't fit the type) but may also result in fewer
3619
+ errors (in the case that the type would have been ambiguous, such as
3620
+ with empty arrays).
3621
+ </p>
3622
+ <p>
3623
+ In the event that the parsing is successful, the resulting <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>
3624
+ is returned.
3625
+ </p>
3626
+ <p>
3627
+ In case of any error, <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> will be returned. If <em class="parameter"><code>error</code></em> is non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
3628
+ then it will be set to reflect the error that occured.
3629
+ </p>
3630
+ <p>
3631
+ Officially, the language understood by the parser is "any string
3632
+ produced by <a class="link" href="glib-GVariant.html#g-variant-print" title="g_variant_print ()"><code class="function">g_variant_print()</code></a>".
3633
+ </p>
3634
+ <div class="variablelist"><table border="0">
3635
+ <col align="left" valign="top">
3636
+ <tbody>
3637
+ <tr>
3638
+ <td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
3639
+ <td>a <a class="link" href="glib-GVariantType.html#GVariantType" title="GVariantType"><span class="type">GVariantType</span></a>, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
3640
+ </td>
3641
+ </tr>
3642
+ <tr>
3643
+ <td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
3644
+ <td>a string containing a GVariant in text form
3645
+ </td>
3646
+ </tr>
3647
+ <tr>
3648
+ <td><p><span class="term"><em class="parameter"><code>limit</code></em> :</span></p></td>
3649
+ <td>a pointer to the end of <em class="parameter"><code>text</code></em>, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
3650
+ </td>
3651
+ </tr>
3652
+ <tr>
3653
+ <td><p><span class="term"><em class="parameter"><code>endptr</code></em> :</span></p></td>
3654
+ <td>a location to store the end pointer, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
3655
+ </td>
3656
+ </tr>
3657
+ <tr>
3658
+ <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3659
+ <td>a pointer to a <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> <a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> pointer, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
3660
+ </td>
3661
+ </tr>
3662
+ <tr>
3663
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3664
+ <td>a reference to a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
3665
+ </td>
3666
+ </tr>
3667
+ </tbody>
3668
+ </table></div>
3669
+ </div>
3670
+ <hr>
3671
+ <div class="refsect2" title="g_variant_new_parsed_va ()">
3672
+ <a name="g-variant-new-parsed-va"></a><h3>g_variant_new_parsed_va ()</h3>
3673
+ <pre class="programlisting"><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * g_variant_new_parsed_va (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *format</code></em>,
3674
+ <em class="parameter"><code><span class="type">va_list</span> *app</code></em>);</pre>
3675
+ <p>
3676
+ Parses <em class="parameter"><code>format</code></em> and returns the result.
3677
+ </p>
3678
+ <p>
3679
+ This is the version of <a class="link" href="glib-GVariant.html#g-variant-new-parsed" title="g_variant_new_parsed ()"><code class="function">g_variant_new_parsed()</code></a> intended to be used
3680
+ from libraries.
3681
+ </p>
3682
+ <p>
3683
+ The return value will be floating if it was a newly created GVariant
3684
+ instance. In the case that <em class="parameter"><code>format</code></em> simply specified the collection
3685
+ of a <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> pointer (eg: <em class="parameter"><code>format</code></em> was "%*") then the collected
3686
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> pointer will be returned unmodified, without adding any
3687
+ additional references.
3688
+ </p>
3689
+ <p>
3690
+ In order to behave correctly in all cases it is necessary for the
3691
+ calling function to <a class="link" href="glib-GVariant.html#g-variant-ref-sink" title="g_variant_ref_sink ()"><code class="function">g_variant_ref_sink()</code></a> the return result before
3692
+ returning control to the user that originally provided the pointer.
3693
+ At this point, the caller will have their own full reference to the
3694
+ result. This can also be done by adding the result to a container,
3695
+ or by passing it to another <a class="link" href="glib-GVariant.html#g-variant-new" title="g_variant_new ()"><code class="function">g_variant_new()</code></a> call.
3696
+ </p>
3697
+ <div class="variablelist"><table border="0">
3698
+ <col align="left" valign="top">
3699
+ <tbody>
3700
+ <tr>
3701
+ <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
3702
+ <td>a text format <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>
3703
+ </td>
3704
+ </tr>
3705
+ <tr>
3706
+ <td><p><span class="term"><em class="parameter"><code>app</code></em> :</span></p></td>
3707
+ <td>a pointer to a <span class="type">va_list</span>
3708
+ </td>
3709
+ </tr>
3710
+ <tr>
3711
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3712
+ <td>a new, usually floating, <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>
3713
+ </td>
3714
+ </tr>
3715
+ </tbody>
3716
+ </table></div>
3717
+ </div>
3718
+ <hr>
3719
+ <div class="refsect2" title="g_variant_new_parsed ()">
3720
+ <a name="g-variant-new-parsed"></a><h3>g_variant_new_parsed ()</h3>
3721
+ <pre class="programlisting"><a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="returnvalue">GVariant</span></a> * g_variant_new_parsed (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *format</code></em>,
3722
+ <em class="parameter"><code>...</code></em>);</pre>
3723
+ <p>
3724
+ Parses <em class="parameter"><code>format</code></em> and returns the result.
3725
+ </p>
3726
+ <p>
3727
+ <em class="parameter"><code>format</code></em> must be a text format <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> with one extention: at any
3728
+ point that a value may appear in the text, a '%' character followed
3729
+ by a GVariant format string (as per <a class="link" href="glib-GVariant.html#g-variant-new" title="g_variant_new ()"><code class="function">g_variant_new()</code></a>) may appear. In
3730
+ that case, the same arguments are collected from the argument list as
3731
+ <a class="link" href="glib-GVariant.html#g-variant-new" title="g_variant_new ()"><code class="function">g_variant_new()</code></a> would have collected.
3732
+ </p>
3733
+ <p>
3734
+ Consider this simple example:
3735
+ </p>
3736
+ <p>
3737
+ </p>
3738
+ <div class="informalexample">
3739
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
3740
+ <tbody>
3741
+ <tr>
3742
+ <td class="listing_lines" align="right"><pre>1</pre></td>
3743
+ <td class="listing_code"><pre class="programlisting"><span class="function"><a href="glib-GVariant.html#g-variant-new-parsed">g_variant_new_parsed</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"[('one', 1), ('two', %i), (%s, 3)]"</span><span class="symbol">,</span><span class="normal"> </span><span class="number">2</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"three"</span><span class="symbol">);</span></pre></td>
3744
+ </tr>
3745
+ </tbody>
3746
+ </table>
3747
+ </div>
3748
+
3749
+ <p>
3750
+ </p>
3751
+ <p>
3752
+ In the example, the variable argument parameters are collected and
3753
+ filled in as if they were part of the original string to produce the
3754
+ result of <code class="code">[('one', 1), ('two', 2), ('three', 3)]</code>.
3755
+ </p>
3756
+ <p>
3757
+ This function is intended only to be used with <em class="parameter"><code>format</code></em> as a string
3758
+ literal. Any parse error is fatal to the calling process. If you
3759
+ want to parse data from untrusted sources, use <a class="link" href="glib-GVariant.html#g-variant-parse" title="g_variant_parse ()"><code class="function">g_variant_parse()</code></a>.
3760
+ </p>
3761
+ <p>
3762
+ You may not use this function to return, unmodified, a single
3763
+ <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> pointer from the argument list. ie: <em class="parameter"><code>format</code></em> may not solely
3764
+ be anything along the lines of "%*", "%?", "<code class="literal">r</code>", or anything starting
3765
+ with "%@".
3766
+ </p>
3767
+ <div class="variablelist"><table border="0">
3768
+ <col align="left" valign="top">
3769
+ <tbody>
3770
+ <tr>
3771
+ <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
3772
+ <td>a text format <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a>
3773
+ </td>
3774
+ </tr>
3775
+ <tr>
3776
+ <td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
3777
+ <td>arguments as per <em class="parameter"><code>format</code></em>
3778
+ </td>
3779
+ </tr>
3780
+ <tr>
3781
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3782
+ <td>a new floating <a class="link" href="glib-GVariant.html#GVariant" title="GVariant"><span class="type">GVariant</span></a> instance
3783
+ </td>
3784
+ </tr>
3785
+ </tbody>
3786
+ </table></div>
3787
+ </div>
3788
+ </div>
3789
+ <div class="refsect1" title="See Also">
3790
+ <a name="glib-GVariant.see-also"></a><h2>See Also</h2>
3791
+ GVariantType
3792
+ </div>
3793
+ </div>
3794
+ <div class="footer">
3795
+ <hr>
3796
+ Generated by GTK-Doc V1.14</div>
3797
+ </body>
3798
+ </html>