gio2 0.90.5-x86-mingw32 → 0.90.6-x86-mingw32

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (830) hide show
  1. data/ChangeLog +41 -0
  2. data/Rakefile +9 -70
  3. data/ext/gio2/extconf.rb +9 -9
  4. data/ext/gio2/gasyncinitable.c +0 -1
  5. data/ext/gio2/gbufferedinputstream.c +0 -19
  6. data/ext/gio2/gbufferedoutputstream.c +0 -34
  7. data/ext/gio2/gcharsetconverter.c +0 -17
  8. data/ext/gio2/gcontenttype.c +1 -8
  9. data/ext/gio2/gconverterinputstream.c +0 -7
  10. data/ext/gio2/gconverteroutputstream.c +0 -7
  11. data/ext/gio2/gdatainputstream.c +34 -57
  12. data/ext/gio2/gdataoutputstream.c +0 -18
  13. data/ext/gio2/gdesktopappinfo.c +0 -2
  14. data/ext/gio2/gemblem.c +0 -19
  15. data/ext/gio2/gfile.c +4 -6
  16. data/ext/gio2/gfileattribute.c +3 -155
  17. data/ext/gio2/gfileattributeinfo.c +89 -0
  18. data/ext/gio2/gfileattributeinfolist.c +109 -0
  19. data/ext/gio2/gfileenumerator.c +0 -2
  20. data/ext/gio2/gfileicon.c +0 -7
  21. data/ext/gio2/gfileinfo.c +4 -11
  22. data/ext/gio2/gfileinputstream.c +0 -2
  23. data/ext/gio2/gfileiostream.c +0 -2
  24. data/ext/gio2/gfilemonitor.c +0 -19
  25. data/ext/gio2/gfileoutputstream.c +1 -5
  26. data/ext/gio2/gfilterinputstream.c +1 -30
  27. data/ext/gio2/gfilteroutputstream.c +1 -30
  28. data/ext/gio2/gicon.c +0 -2
  29. data/ext/gio2/ginetaddress.c +0 -72
  30. data/ext/gio2/ginetsocketaddress.c +0 -16
  31. data/ext/gio2/ginputstream.c +0 -2
  32. data/ext/gio2/gio2.c +11 -1
  33. data/ext/gio2/gio2.h +9 -1
  34. data/ext/gio2/gioerror.c +4 -1
  35. data/ext/gio2/giomodule.c +2 -2
  36. data/ext/gio2/gioscheduler.c +4 -6
  37. data/ext/gio2/giostream.c +0 -23
  38. data/ext/gio2/gloadableicon.c +0 -1
  39. data/ext/gio2/gmemoryoutputstream.c +0 -24
  40. data/ext/gio2/gmount.c +1 -0
  41. data/ext/gio2/gmountoperation.c +1 -103
  42. data/ext/gio2/gnetworkaddress.c +0 -14
  43. data/ext/gio2/gnetworkservice.c +0 -21
  44. data/ext/gio2/goutputstream.c +8 -18
  45. data/ext/gio2/gresolver.c +0 -2
  46. data/ext/gio2/gsocket.c +2 -80
  47. data/ext/gio2/gsocketaddress.c +1 -13
  48. data/ext/gio2/gsocketclient.c +0 -68
  49. data/ext/gio2/gsocketconnection.c +1 -8
  50. data/ext/gio2/gsocketcontrolmessage.c +0 -2
  51. data/ext/gio2/gsocketlistener.c +27 -21
  52. data/ext/gio2/gtcpconnection.c +1 -22
  53. data/ext/gio2/gthreadedsocketservice.c +6 -5
  54. data/ext/gio2/gunixfdlist.c +1 -1
  55. data/ext/gio2/gunixfdmessage.c +0 -9
  56. data/ext/gio2/gunixinputstream.c +0 -24
  57. data/ext/gio2/gunixmounts.c +1 -4
  58. data/ext/gio2/gunixoutputstream.c +0 -24
  59. data/ext/gio2/gunixsocketaddress.c +5 -17
  60. data/ext/gio2/gvfs.c +0 -2
  61. data/ext/gio2/gvolumemonitor.c +0 -2
  62. data/ext/gio2/gzlibcompressor.c +3 -0
  63. data/ext/gio2/util.c +3 -0
  64. data/lib/1.8/gio2.so +0 -0
  65. data/lib/1.9/gio2.so +0 -0
  66. data/lib/gio2.rb +19 -1
  67. data/test/load-test.rb +14 -0
  68. data/test/test_bufferedinputstream.rb +2 -0
  69. data/test/test_charsetconverter.rb +2 -0
  70. data/test/test_datainputstream.rb +7 -0
  71. data/test/test_fileenumerator.rb +8 -0
  72. data/test/test_filemonitor.rb +2 -0
  73. data/test/test_inetaddress.rb +8 -0
  74. metadata +90 -835
  75. data/vendor/local/bin/envsubst.exe +0 -0
  76. data/vendor/local/bin/gettext.exe +0 -0
  77. data/vendor/local/bin/gettext.sh +0 -123
  78. data/vendor/local/bin/glib-genmarshal.exe +0 -0
  79. data/vendor/local/bin/glib-gettextize +0 -188
  80. data/vendor/local/bin/glib-mkenums +0 -537
  81. data/vendor/local/bin/gobject-query.exe +0 -0
  82. data/vendor/local/bin/gspawn-win32-helper-console.exe +0 -0
  83. data/vendor/local/bin/gspawn-win32-helper.exe +0 -0
  84. data/vendor/local/bin/intl.dll +0 -0
  85. data/vendor/local/bin/libasprintf-0.dll +0 -0
  86. data/vendor/local/bin/libgcc_s_dw2-1.dll +0 -0
  87. data/vendor/local/bin/libgio-2.0-0.dll +0 -0
  88. data/vendor/local/bin/libglib-2.0-0.dll +0 -0
  89. data/vendor/local/bin/libgmodule-2.0-0.dll +0 -0
  90. data/vendor/local/bin/libgobject-2.0-0.dll +0 -0
  91. data/vendor/local/bin/libgthread-2.0-0.dll +0 -0
  92. data/vendor/local/bin/ngettext.exe +0 -0
  93. data/vendor/local/include/autosprintf.h +0 -66
  94. data/vendor/local/include/glib-2.0/gio/gappinfo.h +0 -236
  95. data/vendor/local/include/glib-2.0/gio/gasyncinitable.h +0 -119
  96. data/vendor/local/include/glib-2.0/gio/gasyncresult.h +0 -73
  97. data/vendor/local/include/glib-2.0/gio/gbufferedinputstream.h +0 -123
  98. data/vendor/local/include/glib-2.0/gio/gbufferedoutputstream.h +0 -81
  99. data/vendor/local/include/glib-2.0/gio/gcancellable.h +0 -103
  100. data/vendor/local/include/glib-2.0/gio/gcharsetconverter.h +0 -60
  101. data/vendor/local/include/glib-2.0/gio/gcontenttype.h +0 -57
  102. data/vendor/local/include/glib-2.0/gio/gconverter.h +0 -95
  103. data/vendor/local/include/glib-2.0/gio/gconverterinputstream.h +0 -79
  104. data/vendor/local/include/glib-2.0/gio/gconverteroutputstream.h +0 -79
  105. data/vendor/local/include/glib-2.0/gio/gcredentials.h +0 -76
  106. data/vendor/local/include/glib-2.0/gio/gdatainputstream.h +0 -150
  107. data/vendor/local/include/glib-2.0/gio/gdataoutputstream.h +0 -115
  108. data/vendor/local/include/glib-2.0/gio/gdbusaddress.h +0 -58
  109. data/vendor/local/include/glib-2.0/gio/gdbusauthobserver.h +0 -46
  110. data/vendor/local/include/glib-2.0/gio/gdbusconnection.h +0 -562
  111. data/vendor/local/include/glib-2.0/gio/gdbuserror.h +0 -100
  112. data/vendor/local/include/glib-2.0/gio/gdbusintrospection.h +0 -286
  113. data/vendor/local/include/glib-2.0/gio/gdbusmessage.h +0 -149
  114. data/vendor/local/include/glib-2.0/gio/gdbusmethodinvocation.h +0 -73
  115. data/vendor/local/include/glib-2.0/gio/gdbusnameowning.h +0 -112
  116. data/vendor/local/include/glib-2.0/gio/gdbusnamewatching.h +0 -94
  117. data/vendor/local/include/glib-2.0/gio/gdbusproxy.h +0 -167
  118. data/vendor/local/include/glib-2.0/gio/gdbusserver.h +0 -54
  119. data/vendor/local/include/glib-2.0/gio/gdbusutils.h +0 -44
  120. data/vendor/local/include/glib-2.0/gio/gdrive.h +0 -225
  121. data/vendor/local/include/glib-2.0/gio/gemblem.h +0 -58
  122. data/vendor/local/include/glib-2.0/gio/gemblemedicon.h +0 -62
  123. data/vendor/local/include/glib-2.0/gio/gfile.h +0 -1017
  124. data/vendor/local/include/glib-2.0/gio/gfileattribute.h +0 -77
  125. data/vendor/local/include/glib-2.0/gio/gfileenumerator.h +0 -132
  126. data/vendor/local/include/glib-2.0/gio/gfileicon.h +0 -56
  127. data/vendor/local/include/glib-2.0/gio/gfileinfo.h +0 -952
  128. data/vendor/local/include/glib-2.0/gio/gfileinputstream.h +0 -112
  129. data/vendor/local/include/glib-2.0/gio/gfileiostream.h +0 -118
  130. data/vendor/local/include/glib-2.0/gio/gfilemonitor.h +0 -95
  131. data/vendor/local/include/glib-2.0/gio/gfilenamecompleter.h +0 -76
  132. data/vendor/local/include/glib-2.0/gio/gfileoutputstream.h +0 -119
  133. data/vendor/local/include/glib-2.0/gio/gfilterinputstream.h +0 -76
  134. data/vendor/local/include/glib-2.0/gio/gfilteroutputstream.h +0 -76
  135. data/vendor/local/include/glib-2.0/gio/gicon.h +0 -91
  136. data/vendor/local/include/glib-2.0/gio/ginetaddress.h +0 -103
  137. data/vendor/local/include/glib-2.0/gio/ginetsocketaddress.h +0 -69
  138. data/vendor/local/include/glib-2.0/gio/ginitable.h +0 -96
  139. data/vendor/local/include/glib-2.0/gio/ginputstream.h +0 -172
  140. data/vendor/local/include/glib-2.0/gio/gio.h +0 -122
  141. data/vendor/local/include/glib-2.0/gio/gioenums.h +0 -1221
  142. data/vendor/local/include/glib-2.0/gio/gioenumtypes.h +0 -121
  143. data/vendor/local/include/glib-2.0/gio/gioerror.h +0 -52
  144. data/vendor/local/include/glib-2.0/gio/giomodule.h +0 -132
  145. data/vendor/local/include/glib-2.0/gio/gioscheduler.h +0 -52
  146. data/vendor/local/include/glib-2.0/gio/giostream.h +0 -112
  147. data/vendor/local/include/glib-2.0/gio/giotypes.h +0 -375
  148. data/vendor/local/include/glib-2.0/gio/gloadableicon.h +0 -97
  149. data/vendor/local/include/glib-2.0/gio/gmemoryinputstream.h +0 -82
  150. data/vendor/local/include/glib-2.0/gio/gmemoryoutputstream.h +0 -98
  151. data/vendor/local/include/glib-2.0/gio/gmount.h +0 -242
  152. data/vendor/local/include/glib-2.0/gio/gmountoperation.h +0 -123
  153. data/vendor/local/include/glib-2.0/gio/gnativevolumemonitor.h +0 -62
  154. data/vendor/local/include/glib-2.0/gio/gnetworkaddress.h +0 -73
  155. data/vendor/local/include/glib-2.0/gio/gnetworkservice.h +0 -71
  156. data/vendor/local/include/glib-2.0/gio/goutputstream.h +0 -207
  157. data/vendor/local/include/glib-2.0/gio/gpermission.h +0 -118
  158. data/vendor/local/include/glib-2.0/gio/gproxy.h +0 -123
  159. data/vendor/local/include/glib-2.0/gio/gproxyaddress.h +0 -76
  160. data/vendor/local/include/glib-2.0/gio/gproxyaddressenumerator.h +0 -75
  161. data/vendor/local/include/glib-2.0/gio/gproxyresolver.h +0 -96
  162. data/vendor/local/include/glib-2.0/gio/gresolver.h +0 -167
  163. data/vendor/local/include/glib-2.0/gio/gseekable.h +0 -99
  164. data/vendor/local/include/glib-2.0/gio/gsettings.h +0 -258
  165. data/vendor/local/include/glib-2.0/gio/gsettingsbackend.h +0 -138
  166. data/vendor/local/include/glib-2.0/gio/gsimpleasyncresult.h +0 -125
  167. data/vendor/local/include/glib-2.0/gio/gsimplepermission.h +0 -45
  168. data/vendor/local/include/glib-2.0/gio/gsocket.h +0 -194
  169. data/vendor/local/include/glib-2.0/gio/gsocketaddress.h +0 -79
  170. data/vendor/local/include/glib-2.0/gio/gsocketaddressenumerator.h +0 -89
  171. data/vendor/local/include/glib-2.0/gio/gsocketclient.h +0 -152
  172. data/vendor/local/include/glib-2.0/gio/gsocketconnectable.h +0 -74
  173. data/vendor/local/include/glib-2.0/gio/gsocketconnection.h +0 -91
  174. data/vendor/local/include/glib-2.0/gio/gsocketcontrolmessage.h +0 -105
  175. data/vendor/local/include/glib-2.0/gio/gsocketlistener.h +0 -138
  176. data/vendor/local/include/glib-2.0/gio/gsocketservice.h +0 -88
  177. data/vendor/local/include/glib-2.0/gio/gsrvtarget.h +0 -52
  178. data/vendor/local/include/glib-2.0/gio/gtcpconnection.h +0 -68
  179. data/vendor/local/include/glib-2.0/gio/gthemedicon.h +0 -63
  180. data/vendor/local/include/glib-2.0/gio/gthreadedsocketservice.h +0 -81
  181. data/vendor/local/include/glib-2.0/gio/gvfs.h +0 -125
  182. data/vendor/local/include/glib-2.0/gio/gvolume.h +0 -211
  183. data/vendor/local/include/glib-2.0/gio/gvolumemonitor.h +0 -150
  184. data/vendor/local/include/glib-2.0/gio/gzlibcompressor.h +0 -60
  185. data/vendor/local/include/glib-2.0/gio/gzlibdecompressor.h +0 -57
  186. data/vendor/local/include/glib-2.0/glib-object.h +0 -42
  187. data/vendor/local/include/glib-2.0/glib.h +0 -99
  188. data/vendor/local/include/glib-2.0/glib/galloca.h +0 -110
  189. data/vendor/local/include/glib-2.0/glib/garray.h +0 -179
  190. data/vendor/local/include/glib-2.0/glib/gasyncqueue.h +0 -120
  191. data/vendor/local/include/glib-2.0/glib/gatomic.h +0 -105
  192. data/vendor/local/include/glib-2.0/glib/gbacktrace.h +0 -68
  193. data/vendor/local/include/glib-2.0/glib/gbase64.h +0 -57
  194. data/vendor/local/include/glib-2.0/glib/gbitlock.h +0 -43
  195. data/vendor/local/include/glib-2.0/glib/gbookmarkfile.h +0 -215
  196. data/vendor/local/include/glib-2.0/glib/gcache.h +0 -69
  197. data/vendor/local/include/glib-2.0/glib/gchecksum.h +0 -86
  198. data/vendor/local/include/glib-2.0/glib/gcompletion.h +0 -81
  199. data/vendor/local/include/glib-2.0/glib/gconvert.h +0 -162
  200. data/vendor/local/include/glib-2.0/glib/gdataset.h +0 -122
  201. data/vendor/local/include/glib-2.0/glib/gdate.h +0 -263
  202. data/vendor/local/include/glib-2.0/glib/gdatetime.h +0 -217
  203. data/vendor/local/include/glib-2.0/glib/gdir.h +0 -52
  204. data/vendor/local/include/glib-2.0/glib/gerror.h +0 -98
  205. data/vendor/local/include/glib-2.0/glib/gfileutils.h +0 -128
  206. data/vendor/local/include/glib-2.0/glib/ghash.h +0 -166
  207. data/vendor/local/include/glib-2.0/glib/ghook.h +0 -181
  208. data/vendor/local/include/glib-2.0/glib/ghostutils.h +0 -40
  209. data/vendor/local/include/glib-2.0/glib/gi18n-lib.h +0 -38
  210. data/vendor/local/include/glib-2.0/glib/gi18n.h +0 -34
  211. data/vendor/local/include/glib-2.0/glib/giochannel.h +0 -366
  212. data/vendor/local/include/glib-2.0/glib/gkeyfile.h +0 -266
  213. data/vendor/local/include/glib-2.0/glib/glist.h +0 -120
  214. data/vendor/local/include/glib-2.0/glib/gmacros.h +0 -284
  215. data/vendor/local/include/glib-2.0/glib/gmain.h +0 -531
  216. data/vendor/local/include/glib-2.0/glib/gmappedfile.h +0 -49
  217. data/vendor/local/include/glib-2.0/glib/gmarkup.h +0 -163
  218. data/vendor/local/include/glib-2.0/glib/gmem.h +0 -309
  219. data/vendor/local/include/glib-2.0/glib/gmessages.h +0 -343
  220. data/vendor/local/include/glib-2.0/glib/gnode.h +0 -290
  221. data/vendor/local/include/glib-2.0/glib/goption.h +0 -370
  222. data/vendor/local/include/glib-2.0/glib/gpattern.h +0 -49
  223. data/vendor/local/include/glib-2.0/glib/gpoll.h +0 -117
  224. data/vendor/local/include/glib-2.0/glib/gprimes.h +0 -51
  225. data/vendor/local/include/glib-2.0/glib/gprintf.h +0 -52
  226. data/vendor/local/include/glib-2.0/glib/gqsort.h +0 -46
  227. data/vendor/local/include/glib-2.0/glib/gquark.h +0 -52
  228. data/vendor/local/include/glib-2.0/glib/gqueue.h +0 -127
  229. data/vendor/local/include/glib-2.0/glib/grand.h +0 -85
  230. data/vendor/local/include/glib-2.0/glib/gregex.h +0 -471
  231. data/vendor/local/include/glib-2.0/glib/grel.h +0 -101
  232. data/vendor/local/include/glib-2.0/glib/gscanner.h +0 -278
  233. data/vendor/local/include/glib-2.0/glib/gsequence.h +0 -128
  234. data/vendor/local/include/glib-2.0/glib/gshell.h +0 -55
  235. data/vendor/local/include/glib-2.0/glib/gslice.h +0 -86
  236. data/vendor/local/include/glib-2.0/glib/gslist.h +0 -114
  237. data/vendor/local/include/glib-2.0/glib/gspawn.h +0 -139
  238. data/vendor/local/include/glib-2.0/glib/gstdio.h +0 -147
  239. data/vendor/local/include/glib-2.0/glib/gstrfuncs.h +0 -269
  240. data/vendor/local/include/glib-2.0/glib/gstring.h +0 -178
  241. data/vendor/local/include/glib-2.0/glib/gtestutils.h +0 -297
  242. data/vendor/local/include/glib-2.0/glib/gthread.h +0 -407
  243. data/vendor/local/include/glib-2.0/glib/gthreadpool.h +0 -114
  244. data/vendor/local/include/glib-2.0/glib/gtimer.h +0 -65
  245. data/vendor/local/include/glib-2.0/glib/gtimezone.h +0 -44
  246. data/vendor/local/include/glib-2.0/glib/gtree.h +0 -91
  247. data/vendor/local/include/glib-2.0/glib/gtypes.h +0 -451
  248. data/vendor/local/include/glib-2.0/glib/gunicode.h +0 -421
  249. data/vendor/local/include/glib-2.0/glib/gurifuncs.h +0 -81
  250. data/vendor/local/include/glib-2.0/glib/gutils.h +0 -490
  251. data/vendor/local/include/glib-2.0/glib/gvariant.h +0 -248
  252. data/vendor/local/include/glib-2.0/glib/gvarianttype.h +0 -334
  253. data/vendor/local/include/glib-2.0/glib/gwin32.h +0 -114
  254. data/vendor/local/include/glib-2.0/gmodule.h +0 -101
  255. data/vendor/local/include/glib-2.0/gobject/gbinding.h +0 -136
  256. data/vendor/local/include/glib-2.0/gobject/gboxed.h +0 -248
  257. data/vendor/local/include/glib-2.0/gobject/gclosure.h +0 -251
  258. data/vendor/local/include/glib-2.0/gobject/genums.h +0 -261
  259. data/vendor/local/include/glib-2.0/gobject/gmarshal.h +0 -186
  260. data/vendor/local/include/glib-2.0/gobject/gobject.h +0 -567
  261. data/vendor/local/include/glib-2.0/gobject/gobjectnotifyqueue.c +0 -193
  262. data/vendor/local/include/glib-2.0/gobject/gparam.h +0 -415
  263. data/vendor/local/include/glib-2.0/gobject/gparamspecs.h +0 -1137
  264. data/vendor/local/include/glib-2.0/gobject/gsignal.h +0 -509
  265. data/vendor/local/include/glib-2.0/gobject/gsourceclosure.h +0 -51
  266. data/vendor/local/include/glib-2.0/gobject/gtype.h +0 -1736
  267. data/vendor/local/include/glib-2.0/gobject/gtypemodule.h +0 -263
  268. data/vendor/local/include/glib-2.0/gobject/gtypeplugin.h +0 -134
  269. data/vendor/local/include/glib-2.0/gobject/gvalue.h +0 -159
  270. data/vendor/local/include/glib-2.0/gobject/gvaluearray.h +0 -77
  271. data/vendor/local/include/glib-2.0/gobject/gvaluecollector.h +0 -227
  272. data/vendor/local/include/glib-2.0/gobject/gvaluetypes.h +0 -260
  273. data/vendor/local/include/libintl.h +0 -464
  274. data/vendor/local/lib/GNU.Gettext.dll +0 -0
  275. data/vendor/local/lib/gio-2.0.def +0 -1143
  276. data/vendor/local/lib/gio-2.0.lib +0 -0
  277. data/vendor/local/lib/glib-2.0.def +0 -1452
  278. data/vendor/local/lib/glib-2.0.lib +0 -0
  279. data/vendor/local/lib/glib-2.0/include/glibconfig.h +0 -284
  280. data/vendor/local/lib/gmodule-2.0.def +0 -11
  281. data/vendor/local/lib/gmodule-2.0.lib +0 -0
  282. data/vendor/local/lib/gobject-2.0.def +0 -370
  283. data/vendor/local/lib/gobject-2.0.lib +0 -0
  284. data/vendor/local/lib/gthread-2.0.def +0 -3
  285. data/vendor/local/lib/gthread-2.0.lib +0 -0
  286. data/vendor/local/lib/intl.lib +0 -0
  287. data/vendor/local/lib/libasprintf.dll.a +0 -0
  288. data/vendor/local/lib/libgio-2.0.dll.a +0 -0
  289. data/vendor/local/lib/libglib-2.0.dll.a +0 -0
  290. data/vendor/local/lib/libgmodule-2.0.dll.a +0 -0
  291. data/vendor/local/lib/libgobject-2.0.dll.a +0 -0
  292. data/vendor/local/lib/libgthread-2.0.dll.a +0 -0
  293. data/vendor/local/lib/libintl.def +0 -31
  294. data/vendor/local/lib/libintl.dll.a +0 -0
  295. data/vendor/local/lib/pkgconfig/gio-2.0.pc +0 -15
  296. data/vendor/local/lib/pkgconfig/gio-windows-2.0.pc +0 -11
  297. data/vendor/local/lib/pkgconfig/glib-2.0.pc +0 -15
  298. data/vendor/local/lib/pkgconfig/gmodule-2.0.pc +0 -14
  299. data/vendor/local/lib/pkgconfig/gmodule-no-export-2.0.pc +0 -14
  300. data/vendor/local/lib/pkgconfig/gobject-2.0.pc +0 -11
  301. data/vendor/local/lib/pkgconfig/gthread-2.0.pc +0 -11
  302. data/vendor/local/manifest/gettext-runtime-dev_0.18.1.1-2_win32.mft +0 -81
  303. data/vendor/local/manifest/gettext-runtime_0.18.1.1-2_win32.mft +0 -3
  304. data/vendor/local/manifest/glib-dev_2.26.0-2_win32.mft +0 -570
  305. data/vendor/local/manifest/glib_2.26.0-2_win32.mft +0 -102
  306. data/vendor/local/share/aclocal/glib-2.0.m4 +0 -211
  307. data/vendor/local/share/aclocal/glib-gettext.m4 +0 -432
  308. data/vendor/local/share/doc/gettext/bind_textdomain_codeset.3.html +0 -165
  309. data/vendor/local/share/doc/gettext/bindtextdomain.3.html +0 -160
  310. data/vendor/local/share/doc/gettext/csharpdoc/GNU_Gettext.html +0 -8
  311. data/vendor/local/share/doc/gettext/csharpdoc/GNU_Gettext_GettextResourceManager.html +0 -305
  312. data/vendor/local/share/doc/gettext/csharpdoc/GNU_Gettext_GettextResourceSet.html +0 -356
  313. data/vendor/local/share/doc/gettext/csharpdoc/begin.html +0 -11
  314. data/vendor/local/share/doc/gettext/csharpdoc/index.html +0 -10
  315. data/vendor/local/share/doc/gettext/csharpdoc/namespaces.html +0 -6
  316. data/vendor/local/share/doc/gettext/envsubst.1.html +0 -213
  317. data/vendor/local/share/doc/gettext/gettext.1.html +0 -266
  318. data/vendor/local/share/doc/gettext/gettext.3.html +0 -186
  319. data/vendor/local/share/doc/gettext/ngettext.1.html +0 -280
  320. data/vendor/local/share/doc/gettext/ngettext.3.html +0 -143
  321. data/vendor/local/share/doc/gettext/textdomain.3.html +0 -150
  322. data/vendor/local/share/doc/glib-2.26.0/COPYING +0 -482
  323. data/vendor/local/share/doc/glib-dev-2.26.0/COPYING +0 -482
  324. data/vendor/local/share/doc/libasprintf/autosprintf_all.html +0 -174
  325. data/vendor/local/share/glib-2.0/gdb/glib.py +0 -249
  326. data/vendor/local/share/glib-2.0/gdb/gobject.py +0 -305
  327. data/vendor/local/share/glib-2.0/gettext/mkinstalldirs +0 -111
  328. data/vendor/local/share/glib-2.0/gettext/po/Makefile.in.in +0 -279
  329. data/vendor/local/share/glib-2.0/schemas/gschema.dtd +0 -60
  330. data/vendor/local/share/gtk-doc/html/gio/GAppInfo.html +0 -1403
  331. data/vendor/local/share/gtk-doc/html/gio/GAsyncInitable.html +0 -733
  332. data/vendor/local/share/gtk-doc/html/gio/GAsyncResult.html +0 -343
  333. data/vendor/local/share/gtk-doc/html/gio/GBufferedInputStream.html +0 -563
  334. data/vendor/local/share/gtk-doc/html/gio/GBufferedOutputStream.html +0 -291
  335. data/vendor/local/share/gtk-doc/html/gio/GCancellable.html +0 -620
  336. data/vendor/local/share/gtk-doc/html/gio/GCharsetConverter.html +0 -245
  337. data/vendor/local/share/gtk-doc/html/gio/GConverter.html +0 -423
  338. data/vendor/local/share/gtk-doc/html/gio/GCredentials.html +0 -398
  339. data/vendor/local/share/gtk-doc/html/gio/GDBusAuthObserver.html +0 -254
  340. data/vendor/local/share/gtk-doc/html/gio/GDBusConnection.html +0 -6211
  341. data/vendor/local/share/gtk-doc/html/gio/GDBusMessage.html +0 -1833
  342. data/vendor/local/share/gtk-doc/html/gio/GDBusMethodInvocation.html +0 -618
  343. data/vendor/local/share/gtk-doc/html/gio/GDBusProxy.html +0 -2050
  344. data/vendor/local/share/gtk-doc/html/gio/GDBusServer.html +0 -1124
  345. data/vendor/local/share/gtk-doc/html/gio/GDataInputStream.html +0 -1215
  346. data/vendor/local/share/gtk-doc/html/gio/GDataOutputStream.html +0 -540
  347. data/vendor/local/share/gtk-doc/html/gio/GDrive.html +0 -1416
  348. data/vendor/local/share/gtk-doc/html/gio/GEmblem.html +0 -272
  349. data/vendor/local/share/gtk-doc/html/gio/GEmblemedIcon.html +0 -206
  350. data/vendor/local/share/gtk-doc/html/gio/GFile.html +0 -7462
  351. data/vendor/local/share/gtk-doc/html/gio/GFileDescriptorBased.html +0 -120
  352. data/vendor/local/share/gtk-doc/html/gio/GFileEnumerator.html +0 -516
  353. data/vendor/local/share/gtk-doc/html/gio/GFileIOStream.html +0 -312
  354. data/vendor/local/share/gtk-doc/html/gio/GFileIcon.html +0 -155
  355. data/vendor/local/share/gtk-doc/html/gio/GFileInfo.html +0 -3144
  356. data/vendor/local/share/gtk-doc/html/gio/GFileInputStream.html +0 -262
  357. data/vendor/local/share/gtk-doc/html/gio/GFileMonitor.html +0 -353
  358. data/vendor/local/share/gtk-doc/html/gio/GFileOutputStream.html +0 -301
  359. data/vendor/local/share/gtk-doc/html/gio/GFilenameCompleter.html +0 -217
  360. data/vendor/local/share/gtk-doc/html/gio/GFilterInputStream.html +0 -188
  361. data/vendor/local/share/gtk-doc/html/gio/GFilterOutputStream.html +0 -189
  362. data/vendor/local/share/gtk-doc/html/gio/GIOModule.html +0 -261
  363. data/vendor/local/share/gtk-doc/html/gio/GIOStream.html +0 -479
  364. data/vendor/local/share/gtk-doc/html/gio/GIcon.html +0 -331
  365. data/vendor/local/share/gtk-doc/html/gio/GInetAddress.html +0 -717
  366. data/vendor/local/share/gtk-doc/html/gio/GInetSocketAddress.html +0 -196
  367. data/vendor/local/share/gtk-doc/html/gio/GInitable.html +0 -388
  368. data/vendor/local/share/gtk-doc/html/gio/GInputStream.html +0 -808
  369. data/vendor/local/share/gtk-doc/html/gio/GLoadableIcon.html +0 -301
  370. data/vendor/local/share/gtk-doc/html/gio/GMemoryInputStream.html +0 -185
  371. data/vendor/local/share/gtk-doc/html/gio/GMemoryOutputStream.html +0 -393
  372. data/vendor/local/share/gtk-doc/html/gio/GMount.html +0 -1465
  373. data/vendor/local/share/gtk-doc/html/gio/GMountOperation.html +0 -848
  374. data/vendor/local/share/gtk-doc/html/gio/GNetworkAddress.html +0 -343
  375. data/vendor/local/share/gtk-doc/html/gio/GNetworkService.html +0 -311
  376. data/vendor/local/share/gtk-doc/html/gio/GOutputStream.html +0 -1012
  377. data/vendor/local/share/gtk-doc/html/gio/GPermission.html +0 -560
  378. data/vendor/local/share/gtk-doc/html/gio/GProxy.html +0 -312
  379. data/vendor/local/share/gtk-doc/html/gio/GProxyAddress.html +0 -348
  380. data/vendor/local/share/gtk-doc/html/gio/GProxyResolver.html +0 -301
  381. data/vendor/local/share/gtk-doc/html/gio/GResolver.html +0 -787
  382. data/vendor/local/share/gtk-doc/html/gio/GSeekable.html +0 -350
  383. data/vendor/local/share/gtk-doc/html/gio/GSettings.html +0 -2424
  384. data/vendor/local/share/gtk-doc/html/gio/GSettingsBackend.html +0 -609
  385. data/vendor/local/share/gtk-doc/html/gio/GSimpleAsyncResult.html +0 -1193
  386. data/vendor/local/share/gtk-doc/html/gio/GSimplePermission.html +0 -107
  387. data/vendor/local/share/gtk-doc/html/gio/GSocket.html +0 -2438
  388. data/vendor/local/share/gtk-doc/html/gio/GSocketAddress.html +0 -297
  389. data/vendor/local/share/gtk-doc/html/gio/GSocketClient.html +0 -1292
  390. data/vendor/local/share/gtk-doc/html/gio/GSocketConnectable.html +0 -513
  391. data/vendor/local/share/gtk-doc/html/gio/GSocketConnection.html +0 -337
  392. data/vendor/local/share/gtk-doc/html/gio/GSocketControlMessage.html +0 -275
  393. data/vendor/local/share/gtk-doc/html/gio/GSocketListener.html +0 -745
  394. data/vendor/local/share/gtk-doc/html/gio/GSocketService.html +0 -258
  395. data/vendor/local/share/gtk-doc/html/gio/GTcpConnection.html +0 -165
  396. data/vendor/local/share/gtk-doc/html/gio/GThemedIcon.html +0 -377
  397. data/vendor/local/share/gtk-doc/html/gio/GThreadedSocketService.html +0 -197
  398. data/vendor/local/share/gtk-doc/html/gio/GUnixConnection.html +0 -298
  399. data/vendor/local/share/gtk-doc/html/gio/GUnixCredentialsMessage.html +0 -222
  400. data/vendor/local/share/gtk-doc/html/gio/GUnixFDList.html +0 -389
  401. data/vendor/local/share/gtk-doc/html/gio/GUnixFDMessage.html +0 -288
  402. data/vendor/local/share/gtk-doc/html/gio/GUnixInputStream.html +0 -237
  403. data/vendor/local/share/gtk-doc/html/gio/GUnixOutputStream.html +0 -237
  404. data/vendor/local/share/gtk-doc/html/gio/GUnixSocketAddress.html +0 -491
  405. data/vendor/local/share/gtk-doc/html/gio/GVfs.html +0 -274
  406. data/vendor/local/share/gtk-doc/html/gio/GVolume.html +0 -1028
  407. data/vendor/local/share/gtk-doc/html/gio/GVolumeMonitor.html +0 -705
  408. data/vendor/local/share/gtk-doc/html/gio/GZlibCompressor.html +0 -252
  409. data/vendor/local/share/gtk-doc/html/gio/GZlibDecompressor.html +0 -170
  410. data/vendor/local/share/gtk-doc/html/gio/annotation-glossary.html +0 -65
  411. data/vendor/local/share/gtk-doc/html/gio/api-index-2-18.html +0 -153
  412. data/vendor/local/share/gtk-doc/html/gio/api-index-2-20.html +0 -155
  413. data/vendor/local/share/gtk-doc/html/gio/api-index-2-22.html +0 -1084
  414. data/vendor/local/share/gtk-doc/html/gio/api-index-2-24.html +0 -223
  415. data/vendor/local/share/gtk-doc/html/gio/api-index-2-26.html +0 -1598
  416. data/vendor/local/share/gtk-doc/html/gio/api-index-deprecated.html +0 -112
  417. data/vendor/local/share/gtk-doc/html/gio/api-index-full.html +0 -6250
  418. data/vendor/local/share/gtk-doc/html/gio/async.html +0 -44
  419. data/vendor/local/share/gtk-doc/html/gio/ch01.html +0 -207
  420. data/vendor/local/share/gtk-doc/html/gio/ch02.html +0 -50
  421. data/vendor/local/share/gtk-doc/html/gio/ch03.html +0 -180
  422. data/vendor/local/share/gtk-doc/html/gio/ch24.html +0 -75
  423. data/vendor/local/share/gtk-doc/html/gio/ch25.html +0 -217
  424. data/vendor/local/share/gtk-doc/html/gio/ch25s02.html +0 -41
  425. data/vendor/local/share/gtk-doc/html/gio/ch25s03.html +0 -39
  426. data/vendor/local/share/gtk-doc/html/gio/ch26.html +0 -57
  427. data/vendor/local/share/gtk-doc/html/gio/ch26s02.html +0 -59
  428. data/vendor/local/share/gtk-doc/html/gio/ch26s03.html +0 -159
  429. data/vendor/local/share/gtk-doc/html/gio/ch26s04.html +0 -46
  430. data/vendor/local/share/gtk-doc/html/gio/ch26s05.html +0 -48
  431. data/vendor/local/share/gtk-doc/html/gio/ch26s06.html +0 -277
  432. data/vendor/local/share/gtk-doc/html/gio/ch26s07.html +0 -95
  433. data/vendor/local/share/gtk-doc/html/gio/ch27.html +0 -70
  434. data/vendor/local/share/gtk-doc/html/gio/ch27s02.html +0 -130
  435. data/vendor/local/share/gtk-doc/html/gio/ch27s03.html +0 -202
  436. data/vendor/local/share/gtk-doc/html/gio/ch27s04.html +0 -96
  437. data/vendor/local/share/gtk-doc/html/gio/ch27s05.html +0 -823
  438. data/vendor/local/share/gtk-doc/html/gio/ch27s06.html +0 -828
  439. data/vendor/local/share/gtk-doc/html/gio/conversion.html +0 -44
  440. data/vendor/local/share/gtk-doc/html/gio/extending-gio.html +0 -109
  441. data/vendor/local/share/gtk-doc/html/gio/extending.html +0 -41
  442. data/vendor/local/share/gtk-doc/html/gio/failable_initialization.html +0 -38
  443. data/vendor/local/share/gtk-doc/html/gio/file_mon.html +0 -33
  444. data/vendor/local/share/gtk-doc/html/gio/file_ops.html +0 -50
  445. data/vendor/local/share/gtk-doc/html/gio/gdbus-convenience.html +0 -41
  446. data/vendor/local/share/gtk-doc/html/gio/gdbus-lowlevel.html +0 -59
  447. data/vendor/local/share/gtk-doc/html/gio/gdbus.html +0 -243
  448. data/vendor/local/share/gtk-doc/html/gio/gio-D-Bus-Addresses.html +0 -316
  449. data/vendor/local/share/gtk-doc/html/gio/gio-D-Bus-Introspection-Data.html +0 -1117
  450. data/vendor/local/share/gtk-doc/html/gio/gio-D-Bus-Utilities.html +0 -216
  451. data/vendor/local/share/gtk-doc/html/gio/gio-Desktop-file-based-GAppInfo.html +0 -339
  452. data/vendor/local/share/gtk-doc/html/gio/gio-Extension-Points.html +0 -473
  453. data/vendor/local/share/gtk-doc/html/gio/gio-GContentType.html +0 -391
  454. data/vendor/local/share/gtk-doc/html/gio/gio-GConverterInputstream.html +0 -159
  455. data/vendor/local/share/gtk-doc/html/gio/gio-GConverterOutputstream.html +0 -159
  456. data/vendor/local/share/gtk-doc/html/gio/gio-GDBusError.html +0 -908
  457. data/vendor/local/share/gtk-doc/html/gio/gio-GFileAttribute.html +0 -933
  458. data/vendor/local/share/gtk-doc/html/gio/gio-GIOError.html +0 -409
  459. data/vendor/local/share/gtk-doc/html/gio/gio-GIOScheduler.html +0 -297
  460. data/vendor/local/share/gtk-doc/html/gio/gio-GSrvTarget.html +0 -313
  461. data/vendor/local/share/gtk-doc/html/gio/gio-Owning-Bus-Names.html +0 -736
  462. data/vendor/local/share/gtk-doc/html/gio/gio-Unix-Mounts.html +0 -909
  463. data/vendor/local/share/gtk-doc/html/gio/gio-Watching-Bus-Names.html +0 -666
  464. data/vendor/local/share/gtk-doc/html/gio/gio-hierarchy.html +0 -123
  465. data/vendor/local/share/gtk-doc/html/gio/gio-querymodules.html +0 -53
  466. data/vendor/local/share/gtk-doc/html/gio/gio.devhelp +0 -1736
  467. data/vendor/local/share/gtk-doc/html/gio/gio.devhelp2 +0 -2006
  468. data/vendor/local/share/gtk-doc/html/gio/glib-compile-schemas.html +0 -102
  469. data/vendor/local/share/gtk-doc/html/gio/gvfs-overview.png +0 -0
  470. data/vendor/local/share/gtk-doc/html/gio/highlevel-socket.html +0 -53
  471. data/vendor/local/share/gtk-doc/html/gio/home.png +0 -0
  472. data/vendor/local/share/gtk-doc/html/gio/icons.html +0 -50
  473. data/vendor/local/share/gtk-doc/html/gio/index.html +0 -435
  474. data/vendor/local/share/gtk-doc/html/gio/index.sgml +0 -2513
  475. data/vendor/local/share/gtk-doc/html/gio/left.png +0 -0
  476. data/vendor/local/share/gtk-doc/html/gio/migrating.html +0 -62
  477. data/vendor/local/share/gtk-doc/html/gio/networking.html +0 -69
  478. data/vendor/local/share/gtk-doc/html/gio/permissions.html +0 -39
  479. data/vendor/local/share/gtk-doc/html/gio/pt01.html +0 -39
  480. data/vendor/local/share/gtk-doc/html/gio/pt02.html +0 -390
  481. data/vendor/local/share/gtk-doc/html/gio/resolver.html +0 -50
  482. data/vendor/local/share/gtk-doc/html/gio/right.png +0 -0
  483. data/vendor/local/share/gtk-doc/html/gio/settings.html +0 -38
  484. data/vendor/local/share/gtk-doc/html/gio/streaming.html +0 -92
  485. data/vendor/local/share/gtk-doc/html/gio/style.css +0 -265
  486. data/vendor/local/share/gtk-doc/html/gio/tools.html +0 -44
  487. data/vendor/local/share/gtk-doc/html/gio/types.html +0 -41
  488. data/vendor/local/share/gtk-doc/html/gio/up.png +0 -0
  489. data/vendor/local/share/gtk-doc/html/gio/utils.html +0 -33
  490. data/vendor/local/share/gtk-doc/html/gio/volume_mon.html +0 -47
  491. data/vendor/local/share/gtk-doc/html/glib/annotation-glossary.html +0 -77
  492. data/vendor/local/share/gtk-doc/html/glib/api-index-2-10.html +0 -180
  493. data/vendor/local/share/gtk-doc/html/glib/api-index-2-12.html +0 -312
  494. data/vendor/local/share/gtk-doc/html/glib/api-index-2-14.html +0 -559
  495. data/vendor/local/share/gtk-doc/html/glib/api-index-2-16.html +0 -362
  496. data/vendor/local/share/gtk-doc/html/glib/api-index-2-18.html +0 -102
  497. data/vendor/local/share/gtk-doc/html/glib/api-index-2-2.html +0 -124
  498. data/vendor/local/share/gtk-doc/html/glib/api-index-2-20.html +0 -83
  499. data/vendor/local/share/gtk-doc/html/glib/api-index-2-22.html +0 -194
  500. data/vendor/local/share/gtk-doc/html/glib/api-index-2-24.html +0 -420
  501. data/vendor/local/share/gtk-doc/html/glib/api-index-2-26.html +0 -359
  502. data/vendor/local/share/gtk-doc/html/glib/api-index-2-4.html +0 -396
  503. data/vendor/local/share/gtk-doc/html/glib/api-index-2-6.html +0 -417
  504. data/vendor/local/share/gtk-doc/html/glib/api-index-2-8.html +0 -158
  505. data/vendor/local/share/gtk-doc/html/glib/api-index-deprecated.html +0 -419
  506. data/vendor/local/share/gtk-doc/html/glib/api-index-full.html +0 -8214
  507. data/vendor/local/share/gtk-doc/html/glib/file-name-encodings.png +0 -0
  508. data/vendor/local/share/gtk-doc/html/glib/glib-Arrays.html +0 -893
  509. data/vendor/local/share/gtk-doc/html/glib/glib-Asynchronous-Queues.html +0 -818
  510. data/vendor/local/share/gtk-doc/html/glib/glib-Atomic-Operations.html +0 -414
  511. data/vendor/local/share/gtk-doc/html/glib/glib-Automatic-String-Completion.html +0 -466
  512. data/vendor/local/share/gtk-doc/html/glib/glib-Balanced-Binary-Trees.html +0 -802
  513. data/vendor/local/share/gtk-doc/html/glib/glib-Base64-Encoding.html +0 -372
  514. data/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html +0 -500
  515. data/vendor/local/share/gtk-doc/html/glib/glib-Bookmark-file-parser.html +0 -2056
  516. data/vendor/local/share/gtk-doc/html/glib/glib-Byte-Arrays.html +0 -560
  517. data/vendor/local/share/gtk-doc/html/glib/glib-Byte-Order-Macros.html +0 -1686
  518. data/vendor/local/share/gtk-doc/html/glib/glib-Caches.html +0 -398
  519. data/vendor/local/share/gtk-doc/html/glib/glib-Character-Set-Conversion.html +0 -1094
  520. data/vendor/local/share/gtk-doc/html/glib/glib-Commandline-option-parser.html +0 -1671
  521. data/vendor/local/share/gtk-doc/html/glib/glib-Data-Checksums.html +0 -460
  522. data/vendor/local/share/gtk-doc/html/glib/glib-Datasets.html +0 -528
  523. data/vendor/local/share/gtk-doc/html/glib/glib-Date-and-Time-Functions.html +0 -2045
  524. data/vendor/local/share/gtk-doc/html/glib/glib-Double-ended-Queues.html +0 -1278
  525. data/vendor/local/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html +0 -1406
  526. data/vendor/local/share/gtk-doc/html/glib/glib-Dynamic-Loading-of-Modules.html +0 -548
  527. data/vendor/local/share/gtk-doc/html/glib/glib-Error-Reporting.html +0 -1026
  528. data/vendor/local/share/gtk-doc/html/glib/glib-File-Utilities.html +0 -1852
  529. data/vendor/local/share/gtk-doc/html/glib/glib-GDateTime.html +0 -2201
  530. data/vendor/local/share/gtk-doc/html/glib/glib-GTimeZone.html +0 -239
  531. data/vendor/local/share/gtk-doc/html/glib/glib-GVariant.html +0 -4278
  532. data/vendor/local/share/gtk-doc/html/glib/glib-GVariantType.html +0 -1864
  533. data/vendor/local/share/gtk-doc/html/glib/glib-Glob-style-pattern-matching.html +0 -295
  534. data/vendor/local/share/gtk-doc/html/glib/glib-Hash-Tables.html +0 -1512
  535. data/vendor/local/share/gtk-doc/html/glib/glib-Hook-Functions.html +0 -1367
  536. data/vendor/local/share/gtk-doc/html/glib/glib-Hostname-Utilities.html +0 -229
  537. data/vendor/local/share/gtk-doc/html/glib/glib-I18N.html +0 -692
  538. data/vendor/local/share/gtk-doc/html/glib/glib-IO-Channels.html +0 -2196
  539. data/vendor/local/share/gtk-doc/html/glib/glib-Key-value-file-parser.html +0 -2740
  540. data/vendor/local/share/gtk-doc/html/glib/glib-Keyed-Data-Lists.html +0 -612
  541. data/vendor/local/share/gtk-doc/html/glib/glib-Lexical-Scanner.html +0 -1451
  542. data/vendor/local/share/gtk-doc/html/glib/glib-Limits-of-Basic-Types.html +0 -389
  543. data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocation.html +0 -1033
  544. data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocators.html +0 -141
  545. data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Chunks.html +0 -706
  546. data/vendor/local/share/gtk-doc/html/glib/glib-Memory-Slices.html +0 -510
  547. data/vendor/local/share/gtk-doc/html/glib/glib-Message-Logging.html +0 -748
  548. data/vendor/local/share/gtk-doc/html/glib/glib-Miscellaneous-Macros.html +0 -1105
  549. data/vendor/local/share/gtk-doc/html/glib/glib-Miscellaneous-Utility-Functions.html +0 -1552
  550. data/vendor/local/share/gtk-doc/html/glib/glib-N-ary-Trees.html +0 -1468
  551. data/vendor/local/share/gtk-doc/html/glib/glib-Numerical-Definitions.html +0 -194
  552. data/vendor/local/share/gtk-doc/html/glib/glib-Perl-compatible-regular-expressions.html +0 -2745
  553. data/vendor/local/share/gtk-doc/html/glib/glib-Pointer-Arrays.html +0 -752
  554. data/vendor/local/share/gtk-doc/html/glib/glib-Quarks.html +0 -269
  555. data/vendor/local/share/gtk-doc/html/glib/glib-Random-Numbers.html +0 -578
  556. data/vendor/local/share/gtk-doc/html/glib/glib-Relations-and-Tuples.html +0 -532
  557. data/vendor/local/share/gtk-doc/html/glib/glib-Sequences.html +0 -1353
  558. data/vendor/local/share/gtk-doc/html/glib/glib-Shell-related-Utilities.html +0 -238
  559. data/vendor/local/share/gtk-doc/html/glib/glib-Simple-XML-Subset-Parser.html +0 -1282
  560. data/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html +0 -1213
  561. data/vendor/local/share/gtk-doc/html/glib/glib-Spawning-Processes.html +0 -924
  562. data/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html +0 -470
  563. data/vendor/local/share/gtk-doc/html/glib/glib-String-Chunks.html +0 -301
  564. data/vendor/local/share/gtk-doc/html/glib/glib-String-Utility-Functions.html +0 -2960
  565. data/vendor/local/share/gtk-doc/html/glib/glib-Strings.html +0 -1291
  566. data/vendor/local/share/gtk-doc/html/glib/glib-Testing.html +0 -1805
  567. data/vendor/local/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html +0 -3478
  568. data/vendor/local/share/gtk-doc/html/glib/glib-Thread-Pools.html +0 -606
  569. data/vendor/local/share/gtk-doc/html/glib/glib-Threads.html +0 -3411
  570. data/vendor/local/share/gtk-doc/html/glib/glib-Timers.html +0 -245
  571. data/vendor/local/share/gtk-doc/html/glib/glib-Trash-Stacks.html +0 -188
  572. data/vendor/local/share/gtk-doc/html/glib/glib-Type-Conversion-Macros.html +0 -263
  573. data/vendor/local/share/gtk-doc/html/glib/glib-URI-Functions.html +0 -400
  574. data/vendor/local/share/gtk-doc/html/glib/glib-Unicode-Manipulation.html +0 -3448
  575. data/vendor/local/share/gtk-doc/html/glib/glib-Version-Information.html +0 -253
  576. data/vendor/local/share/gtk-doc/html/glib/glib-Warnings-and-Assertions.html +0 -438
  577. data/vendor/local/share/gtk-doc/html/glib/glib-Windows-Compatibility-Functions.html +0 -476
  578. data/vendor/local/share/gtk-doc/html/glib/glib-building.html +0 -466
  579. data/vendor/local/share/gtk-doc/html/glib/glib-changes.html +0 -159
  580. data/vendor/local/share/gtk-doc/html/glib/glib-compiling.html +0 -118
  581. data/vendor/local/share/gtk-doc/html/glib/glib-core.html +0 -64
  582. data/vendor/local/share/gtk-doc/html/glib/glib-cross-compiling.html +0 -160
  583. data/vendor/local/share/gtk-doc/html/glib/glib-data-types.html +0 -120
  584. data/vendor/local/share/gtk-doc/html/glib/glib-fundamentals.html +0 -59
  585. data/vendor/local/share/gtk-doc/html/glib/glib-gettextize.html +0 -93
  586. data/vendor/local/share/gtk-doc/html/glib/glib-regex-syntax.html +0 -2217
  587. data/vendor/local/share/gtk-doc/html/glib/glib-resources.html +0 -121
  588. data/vendor/local/share/gtk-doc/html/glib/glib-running.html +0 -319
  589. data/vendor/local/share/gtk-doc/html/glib/glib-utilities.html +0 -118
  590. data/vendor/local/share/gtk-doc/html/glib/glib.devhelp +0 -2183
  591. data/vendor/local/share/gtk-doc/html/glib/glib.devhelp2 +0 -2671
  592. data/vendor/local/share/gtk-doc/html/glib/glib.html +0 -80
  593. data/vendor/local/share/gtk-doc/html/glib/gtester-report.html +0 -72
  594. data/vendor/local/share/gtk-doc/html/glib/gtester.html +0 -131
  595. data/vendor/local/share/gtk-doc/html/glib/gvariant-format-strings.html +0 -1288
  596. data/vendor/local/share/gtk-doc/html/glib/home.png +0 -0
  597. data/vendor/local/share/gtk-doc/html/glib/index.html +0 -344
  598. data/vendor/local/share/gtk-doc/html/glib/index.sgml +0 -2846
  599. data/vendor/local/share/gtk-doc/html/glib/left.png +0 -0
  600. data/vendor/local/share/gtk-doc/html/glib/mainloop-states.gif +0 -0
  601. data/vendor/local/share/gtk-doc/html/glib/right.png +0 -0
  602. data/vendor/local/share/gtk-doc/html/glib/style.css +0 -265
  603. data/vendor/local/share/gtk-doc/html/glib/tools.html +0 -41
  604. data/vendor/local/share/gtk-doc/html/glib/up.png +0 -0
  605. data/vendor/local/share/gtk-doc/html/gobject/GBinding.html +0 -803
  606. data/vendor/local/share/gtk-doc/html/gobject/GTypeModule.html +0 -710
  607. data/vendor/local/share/gtk-doc/html/gobject/GTypePlugin.html +0 -453
  608. data/vendor/local/share/gtk-doc/html/gobject/annotation-glossary.html +0 -47
  609. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-10.html +0 -85
  610. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-12.html +0 -55
  611. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-14.html +0 -51
  612. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-18.html +0 -46
  613. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-2.html +0 -38
  614. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-22.html +0 -46
  615. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-24.html +0 -73
  616. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-26.html +0 -201
  617. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-4.html +0 -178
  618. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-6.html +0 -42
  619. data/vendor/local/share/gtk-doc/html/gobject/api-index-2-8.html +0 -42
  620. data/vendor/local/share/gtk-doc/html/gobject/api-index-deprecated.html +0 -50
  621. data/vendor/local/share/gtk-doc/html/gobject/api-index-full.html +0 -2721
  622. data/vendor/local/share/gtk-doc/html/gobject/ch01s02.html +0 -136
  623. data/vendor/local/share/gtk-doc/html/gobject/ch06s03.html +0 -113
  624. data/vendor/local/share/gtk-doc/html/gobject/chapter-gobject.html +0 -293
  625. data/vendor/local/share/gtk-doc/html/gobject/chapter-gtype.html +0 -263
  626. data/vendor/local/share/gtk-doc/html/gobject/chapter-intro.html +0 -92
  627. data/vendor/local/share/gtk-doc/html/gobject/chapter-signal.html +0 -214
  628. data/vendor/local/share/gtk-doc/html/gobject/glib-genmarshal.html +0 -361
  629. data/vendor/local/share/gtk-doc/html/gobject/glib-mkenums.html +0 -307
  630. data/vendor/local/share/gtk-doc/html/gobject/glue.png +0 -0
  631. data/vendor/local/share/gtk-doc/html/gobject/gobject-Boxed-Types.html +0 -417
  632. data/vendor/local/share/gtk-doc/html/gobject/gobject-Closures.html +0 -2412
  633. data/vendor/local/share/gtk-doc/html/gobject/gobject-Enumeration-and-Flag-Types.html +0 -847
  634. data/vendor/local/share/gtk-doc/html/gobject/gobject-GParamSpec.html +0 -1433
  635. data/vendor/local/share/gtk-doc/html/gobject/gobject-Generic-values.html +0 -776
  636. data/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html +0 -2741
  637. data/vendor/local/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html +0 -5555
  638. data/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html +0 -2875
  639. data/vendor/local/share/gtk-doc/html/gobject/gobject-Type-Information.html +0 -4460
  640. data/vendor/local/share/gtk-doc/html/gobject/gobject-Value-arrays.html +0 -416
  641. data/vendor/local/share/gtk-doc/html/gobject/gobject-Varargs-Value-Collection.html +0 -260
  642. data/vendor/local/share/gtk-doc/html/gobject/gobject-memory.html +0 -234
  643. data/vendor/local/share/gtk-doc/html/gobject/gobject-properties.html +0 -270
  644. data/vendor/local/share/gtk-doc/html/gobject/gobject-query.html +0 -117
  645. data/vendor/local/share/gtk-doc/html/gobject/gobject.devhelp +0 -762
  646. data/vendor/local/share/gtk-doc/html/gobject/gobject.devhelp2 +0 -801
  647. data/vendor/local/share/gtk-doc/html/gobject/gtype-conventions.html +0 -143
  648. data/vendor/local/share/gtk-doc/html/gobject/gtype-instantiable-classed.html +0 -287
  649. data/vendor/local/share/gtk-doc/html/gobject/gtype-non-instantiable-classed.html +0 -316
  650. data/vendor/local/share/gtk-doc/html/gobject/gtype-non-instantiable.html +0 -76
  651. data/vendor/local/share/gtk-doc/html/gobject/home.png +0 -0
  652. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-chainup.html +0 -100
  653. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-code.html +0 -86
  654. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-construction.html +0 -113
  655. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-destruction.html +0 -122
  656. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject-methods.html +0 -257
  657. data/vendor/local/share/gtk-doc/html/gobject/howto-gobject.html +0 -283
  658. data/vendor/local/share/gtk-doc/html/gobject/howto-interface-implement.html +0 -125
  659. data/vendor/local/share/gtk-doc/html/gobject/howto-interface-properties.html +0 -167
  660. data/vendor/local/share/gtk-doc/html/gobject/howto-interface.html +0 -160
  661. data/vendor/local/share/gtk-doc/html/gobject/howto-signals.html +0 -121
  662. data/vendor/local/share/gtk-doc/html/gobject/index.html +0 -192
  663. data/vendor/local/share/gtk-doc/html/gobject/index.sgml +0 -786
  664. data/vendor/local/share/gtk-doc/html/gobject/left.png +0 -0
  665. data/vendor/local/share/gtk-doc/html/gobject/pr01.html +0 -72
  666. data/vendor/local/share/gtk-doc/html/gobject/pt01.html +0 -80
  667. data/vendor/local/share/gtk-doc/html/gobject/pt02.html +0 -66
  668. data/vendor/local/share/gtk-doc/html/gobject/pt03.html +0 -55
  669. data/vendor/local/share/gtk-doc/html/gobject/right.png +0 -0
  670. data/vendor/local/share/gtk-doc/html/gobject/rn01.html +0 -85
  671. data/vendor/local/share/gtk-doc/html/gobject/rn02.html +0 -47
  672. data/vendor/local/share/gtk-doc/html/gobject/signal.html +0 -377
  673. data/vendor/local/share/gtk-doc/html/gobject/style.css +0 -265
  674. data/vendor/local/share/gtk-doc/html/gobject/tools-ginspector.html +0 -35
  675. data/vendor/local/share/gtk-doc/html/gobject/tools-gob.html +0 -40
  676. data/vendor/local/share/gtk-doc/html/gobject/tools-gtkdoc.html +0 -63
  677. data/vendor/local/share/gtk-doc/html/gobject/tools-refdb.html +0 -55
  678. data/vendor/local/share/gtk-doc/html/gobject/tools-vala.html +0 -43
  679. data/vendor/local/share/gtk-doc/html/gobject/up.png +0 -0
  680. data/vendor/local/share/locale/af/LC_MESSAGES/glib20.mo +0 -0
  681. data/vendor/local/share/locale/am/LC_MESSAGES/glib20.mo +0 -0
  682. data/vendor/local/share/locale/ar/LC_MESSAGES/glib20.mo +0 -0
  683. data/vendor/local/share/locale/as/LC_MESSAGES/glib20.mo +0 -0
  684. data/vendor/local/share/locale/ast/LC_MESSAGES/glib20.mo +0 -0
  685. data/vendor/local/share/locale/az/LC_MESSAGES/glib20.mo +0 -0
  686. data/vendor/local/share/locale/be/LC_MESSAGES/gettext-runtime.mo +0 -0
  687. data/vendor/local/share/locale/be/LC_MESSAGES/glib20.mo +0 -0
  688. data/vendor/local/share/locale/be@latin/LC_MESSAGES/glib20.mo +0 -0
  689. data/vendor/local/share/locale/bg/LC_MESSAGES/gettext-runtime.mo +0 -0
  690. data/vendor/local/share/locale/bg/LC_MESSAGES/glib20.mo +0 -0
  691. data/vendor/local/share/locale/bn/LC_MESSAGES/glib20.mo +0 -0
  692. data/vendor/local/share/locale/bn_IN/LC_MESSAGES/glib20.mo +0 -0
  693. data/vendor/local/share/locale/bs/LC_MESSAGES/glib20.mo +0 -0
  694. data/vendor/local/share/locale/ca/LC_MESSAGES/gettext-runtime.mo +0 -0
  695. data/vendor/local/share/locale/ca/LC_MESSAGES/glib20.mo +0 -0
  696. data/vendor/local/share/locale/ca@valencia/LC_MESSAGES/glib20.mo +0 -0
  697. data/vendor/local/share/locale/cs/LC_MESSAGES/gettext-runtime.mo +0 -0
  698. data/vendor/local/share/locale/cs/LC_MESSAGES/glib20.mo +0 -0
  699. data/vendor/local/share/locale/cy/LC_MESSAGES/glib20.mo +0 -0
  700. data/vendor/local/share/locale/da/LC_MESSAGES/gettext-runtime.mo +0 -0
  701. data/vendor/local/share/locale/da/LC_MESSAGES/glib20.mo +0 -0
  702. data/vendor/local/share/locale/de/LC_MESSAGES/gettext-runtime.mo +0 -0
  703. data/vendor/local/share/locale/de/LC_MESSAGES/glib20.mo +0 -0
  704. data/vendor/local/share/locale/dz/LC_MESSAGES/glib20.mo +0 -0
  705. data/vendor/local/share/locale/el/LC_MESSAGES/gettext-runtime.mo +0 -0
  706. data/vendor/local/share/locale/el/LC_MESSAGES/glib20.mo +0 -0
  707. data/vendor/local/share/locale/en@boldquot/LC_MESSAGES/gettext-runtime.mo +0 -0
  708. data/vendor/local/share/locale/en@quot/LC_MESSAGES/gettext-runtime.mo +0 -0
  709. data/vendor/local/share/locale/en@shaw/LC_MESSAGES/glib20.mo +0 -0
  710. data/vendor/local/share/locale/en_CA/LC_MESSAGES/glib20.mo +0 -0
  711. data/vendor/local/share/locale/en_GB/LC_MESSAGES/glib20.mo +0 -0
  712. data/vendor/local/share/locale/eo/LC_MESSAGES/gettext-runtime.mo +0 -0
  713. data/vendor/local/share/locale/eo/LC_MESSAGES/glib20.mo +0 -0
  714. data/vendor/local/share/locale/es/LC_MESSAGES/gettext-runtime.mo +0 -0
  715. data/vendor/local/share/locale/es/LC_MESSAGES/glib20.mo +0 -0
  716. data/vendor/local/share/locale/et/LC_MESSAGES/gettext-runtime.mo +0 -0
  717. data/vendor/local/share/locale/et/LC_MESSAGES/glib20.mo +0 -0
  718. data/vendor/local/share/locale/eu/LC_MESSAGES/glib20.mo +0 -0
  719. data/vendor/local/share/locale/fa/LC_MESSAGES/glib20.mo +0 -0
  720. data/vendor/local/share/locale/fi/LC_MESSAGES/gettext-runtime.mo +0 -0
  721. data/vendor/local/share/locale/fi/LC_MESSAGES/glib20.mo +0 -0
  722. data/vendor/local/share/locale/fr/LC_MESSAGES/gettext-runtime.mo +0 -0
  723. data/vendor/local/share/locale/fr/LC_MESSAGES/glib20.mo +0 -0
  724. data/vendor/local/share/locale/ga/LC_MESSAGES/gettext-runtime.mo +0 -0
  725. data/vendor/local/share/locale/ga/LC_MESSAGES/glib20.mo +0 -0
  726. data/vendor/local/share/locale/gl/LC_MESSAGES/gettext-runtime.mo +0 -0
  727. data/vendor/local/share/locale/gl/LC_MESSAGES/glib20.mo +0 -0
  728. data/vendor/local/share/locale/gu/LC_MESSAGES/glib20.mo +0 -0
  729. data/vendor/local/share/locale/he/LC_MESSAGES/glib20.mo +0 -0
  730. data/vendor/local/share/locale/hi/LC_MESSAGES/glib20.mo +0 -0
  731. data/vendor/local/share/locale/hr/LC_MESSAGES/glib20.mo +0 -0
  732. data/vendor/local/share/locale/hu/LC_MESSAGES/glib20.mo +0 -0
  733. data/vendor/local/share/locale/hy/LC_MESSAGES/glib20.mo +0 -0
  734. data/vendor/local/share/locale/id/LC_MESSAGES/gettext-runtime.mo +0 -0
  735. data/vendor/local/share/locale/id/LC_MESSAGES/glib20.mo +0 -0
  736. data/vendor/local/share/locale/is/LC_MESSAGES/glib20.mo +0 -0
  737. data/vendor/local/share/locale/it/LC_MESSAGES/gettext-runtime.mo +0 -0
  738. data/vendor/local/share/locale/it/LC_MESSAGES/glib20.mo +0 -0
  739. data/vendor/local/share/locale/ja/LC_MESSAGES/gettext-runtime.mo +0 -0
  740. data/vendor/local/share/locale/ja/LC_MESSAGES/glib20.mo +0 -0
  741. data/vendor/local/share/locale/ka/LC_MESSAGES/glib20.mo +0 -0
  742. data/vendor/local/share/locale/kk/LC_MESSAGES/glib20.mo +0 -0
  743. data/vendor/local/share/locale/kn/LC_MESSAGES/glib20.mo +0 -0
  744. data/vendor/local/share/locale/ko/LC_MESSAGES/gettext-runtime.mo +0 -0
  745. data/vendor/local/share/locale/ko/LC_MESSAGES/glib20.mo +0 -0
  746. data/vendor/local/share/locale/ku/LC_MESSAGES/glib20.mo +0 -0
  747. data/vendor/local/share/locale/locale.alias +0 -77
  748. data/vendor/local/share/locale/lt/LC_MESSAGES/glib20.mo +0 -0
  749. data/vendor/local/share/locale/lv/LC_MESSAGES/glib20.mo +0 -0
  750. data/vendor/local/share/locale/mai/LC_MESSAGES/glib20.mo +0 -0
  751. data/vendor/local/share/locale/mg/LC_MESSAGES/glib20.mo +0 -0
  752. data/vendor/local/share/locale/mk/LC_MESSAGES/glib20.mo +0 -0
  753. data/vendor/local/share/locale/ml/LC_MESSAGES/glib20.mo +0 -0
  754. data/vendor/local/share/locale/mn/LC_MESSAGES/glib20.mo +0 -0
  755. data/vendor/local/share/locale/mr/LC_MESSAGES/glib20.mo +0 -0
  756. data/vendor/local/share/locale/ms/LC_MESSAGES/glib20.mo +0 -0
  757. data/vendor/local/share/locale/nb/LC_MESSAGES/gettext-runtime.mo +0 -0
  758. data/vendor/local/share/locale/nb/LC_MESSAGES/glib20.mo +0 -0
  759. data/vendor/local/share/locale/nds/LC_MESSAGES/glib20.mo +0 -0
  760. data/vendor/local/share/locale/ne/LC_MESSAGES/glib20.mo +0 -0
  761. data/vendor/local/share/locale/nl/LC_MESSAGES/gettext-runtime.mo +0 -0
  762. data/vendor/local/share/locale/nl/LC_MESSAGES/glib20.mo +0 -0
  763. data/vendor/local/share/locale/nn/LC_MESSAGES/gettext-runtime.mo +0 -0
  764. data/vendor/local/share/locale/nn/LC_MESSAGES/glib20.mo +0 -0
  765. data/vendor/local/share/locale/oc/LC_MESSAGES/glib20.mo +0 -0
  766. data/vendor/local/share/locale/or/LC_MESSAGES/glib20.mo +0 -0
  767. data/vendor/local/share/locale/pa/LC_MESSAGES/glib20.mo +0 -0
  768. data/vendor/local/share/locale/pl/LC_MESSAGES/gettext-runtime.mo +0 -0
  769. data/vendor/local/share/locale/pl/LC_MESSAGES/glib20.mo +0 -0
  770. data/vendor/local/share/locale/ps/LC_MESSAGES/glib20.mo +0 -0
  771. data/vendor/local/share/locale/pt/LC_MESSAGES/gettext-runtime.mo +0 -0
  772. data/vendor/local/share/locale/pt/LC_MESSAGES/glib20.mo +0 -0
  773. data/vendor/local/share/locale/pt_BR/LC_MESSAGES/gettext-runtime.mo +0 -0
  774. data/vendor/local/share/locale/pt_BR/LC_MESSAGES/glib20.mo +0 -0
  775. data/vendor/local/share/locale/ro/LC_MESSAGES/gettext-runtime.mo +0 -0
  776. data/vendor/local/share/locale/ro/LC_MESSAGES/glib20.mo +0 -0
  777. data/vendor/local/share/locale/ru/LC_MESSAGES/gettext-runtime.mo +0 -0
  778. data/vendor/local/share/locale/ru/LC_MESSAGES/glib20.mo +0 -0
  779. data/vendor/local/share/locale/rw/LC_MESSAGES/glib20.mo +0 -0
  780. data/vendor/local/share/locale/si/LC_MESSAGES/glib20.mo +0 -0
  781. data/vendor/local/share/locale/sk/LC_MESSAGES/gettext-runtime.mo +0 -0
  782. data/vendor/local/share/locale/sk/LC_MESSAGES/glib20.mo +0 -0
  783. data/vendor/local/share/locale/sl/LC_MESSAGES/gettext-runtime.mo +0 -0
  784. data/vendor/local/share/locale/sl/LC_MESSAGES/glib20.mo +0 -0
  785. data/vendor/local/share/locale/sq/LC_MESSAGES/glib20.mo +0 -0
  786. data/vendor/local/share/locale/sr/LC_MESSAGES/gettext-runtime.mo +0 -0
  787. data/vendor/local/share/locale/sr/LC_MESSAGES/glib20.mo +0 -0
  788. data/vendor/local/share/locale/sr@ije/LC_MESSAGES/glib20.mo +0 -0
  789. data/vendor/local/share/locale/sr@latin/LC_MESSAGES/glib20.mo +0 -0
  790. data/vendor/local/share/locale/sv/LC_MESSAGES/gettext-runtime.mo +0 -0
  791. data/vendor/local/share/locale/sv/LC_MESSAGES/glib20.mo +0 -0
  792. data/vendor/local/share/locale/ta/LC_MESSAGES/glib20.mo +0 -0
  793. data/vendor/local/share/locale/te/LC_MESSAGES/glib20.mo +0 -0
  794. data/vendor/local/share/locale/th/LC_MESSAGES/glib20.mo +0 -0
  795. data/vendor/local/share/locale/tl/LC_MESSAGES/glib20.mo +0 -0
  796. data/vendor/local/share/locale/tr/LC_MESSAGES/gettext-runtime.mo +0 -0
  797. data/vendor/local/share/locale/tr/LC_MESSAGES/glib20.mo +0 -0
  798. data/vendor/local/share/locale/tt/LC_MESSAGES/glib20.mo +0 -0
  799. data/vendor/local/share/locale/uk/LC_MESSAGES/gettext-runtime.mo +0 -0
  800. data/vendor/local/share/locale/uk/LC_MESSAGES/glib20.mo +0 -0
  801. data/vendor/local/share/locale/vi/LC_MESSAGES/gettext-runtime.mo +0 -0
  802. data/vendor/local/share/locale/vi/LC_MESSAGES/glib20.mo +0 -0
  803. data/vendor/local/share/locale/wa/LC_MESSAGES/glib20.mo +0 -0
  804. data/vendor/local/share/locale/xh/LC_MESSAGES/glib20.mo +0 -0
  805. data/vendor/local/share/locale/yi/LC_MESSAGES/glib20.mo +0 -0
  806. data/vendor/local/share/locale/zh_CN/LC_MESSAGES/gettext-runtime.mo +0 -0
  807. data/vendor/local/share/locale/zh_CN/LC_MESSAGES/glib20.mo +0 -0
  808. data/vendor/local/share/locale/zh_HK/LC_MESSAGES/gettext-runtime.mo +0 -0
  809. data/vendor/local/share/locale/zh_HK/LC_MESSAGES/glib20.mo +0 -0
  810. data/vendor/local/share/locale/zh_TW/LC_MESSAGES/gettext-runtime.mo +0 -0
  811. data/vendor/local/share/locale/zh_TW/LC_MESSAGES/glib20.mo +0 -0
  812. data/vendor/local/share/man/man1/envsubst.1 +0 -54
  813. data/vendor/local/share/man/man1/gettext.1 +0 -69
  814. data/vendor/local/share/man/man1/glib-genmarshal.1 +0 -312
  815. data/vendor/local/share/man/man1/glib-mkenums.1 +0 -246
  816. data/vendor/local/share/man/man1/gobject-query.1 +0 -83
  817. data/vendor/local/share/man/man1/ngettext.1 +0 -68
  818. data/vendor/local/share/man/man3/bind_textdomain_codeset.3 +0 -72
  819. data/vendor/local/share/man/man3/bindtextdomain.3 +0 -69
  820. data/vendor/local/share/man/man3/dcgettext.3 +0 -1
  821. data/vendor/local/share/man/man3/dcngettext.3 +0 -1
  822. data/vendor/local/share/man/man3/dgettext.3 +0 -1
  823. data/vendor/local/share/man/man3/dngettext.3 +0 -1
  824. data/vendor/local/share/man/man3/gettext.3 +0 -99
  825. data/vendor/local/share/man/man3/ngettext.3 +0 -60
  826. data/vendor/local/share/man/man3/textdomain.3 +0 -57
  827. data/vendor/local/src/tml/packaging/gettext_0.18.1.1-2_win32.log +0 -10423
  828. data/vendor/local/src/tml/packaging/gettext_0.18.1.1-2_win32.sh +0 -457
  829. data/vendor/local/src/tml/packaging/glib_2.26.0-2_win32.log +0 -2867
  830. data/vendor/local/src/tml/packaging/glib_2.26.0-2_win32.sh +0 -64
data/vendor/local/share/gtk-doc/html/glib/glib-String-Chunks.html DELETED
@@ -1,301 +0,0 @@
1
- <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
- <html>
3
- <head>
4
- <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
- <title>String Chunks</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-Strings.html" title="Strings">
10
- <link rel="next" href="glib-Arrays.html" title="Arrays">
11
- <meta name="generator" content="GTK-Doc V1.15.1 (XML mode)">
12
- <link rel="stylesheet" href="style.css" type="text/css">
13
- </head>
14
- <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
- <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
16
- <tr valign="middle">
17
- <td><a accesskey="p" href="glib-Strings.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="glib-Arrays.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-String-Chunks.synopsis" class="shortcut">Top</a>
25
-  | 
26
- <a href="#glib-String-Chunks.description" class="shortcut">Description</a>
27
- </td></tr>
28
- </table>
29
- <div class="refentry">
30
- <a name="glib-String-Chunks"></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-String-Chunks.top_of_page"></a>String Chunks</span></h2>
34
- <p>String Chunks — efficient storage of groups of strings</p>
35
- </td>
36
- <td valign="top" align="right"></td>
37
- </tr></table></div>
38
- <div class="refsynopsisdiv">
39
- <a name="glib-String-Chunks.synopsis"></a><h2>Synopsis</h2>
40
- <pre class="synopsis">
41
- #include &lt;glib.h&gt;
42
-
43
- <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk">GStringChunk</a>;
44
- <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="returnvalue">GStringChunk</span></a> * <a class="link" href="glib-String-Chunks.html#g-string-chunk-new" title="g_string_chunk_new ()">g_string_chunk_new</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> size</code></em>);
45
- <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-String-Chunks.html#g-string-chunk-insert" title="g_string_chunk_insert ()">g_string_chunk_insert</a> (<em class="parameter"><code><a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a> *chunk</code></em>,
46
- <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>);
47
- <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-String-Chunks.html#g-string-chunk-insert-const" title="g_string_chunk_insert_const ()">g_string_chunk_insert_const</a> (<em class="parameter"><code><a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a> *chunk</code></em>,
48
- <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>);
49
- <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-String-Chunks.html#g-string-chunk-insert-len" title="g_string_chunk_insert_len ()">g_string_chunk_insert_len</a> (<em class="parameter"><code><a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a> *chunk</code></em>,
50
- <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>,
51
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> len</code></em>);
52
- <span class="returnvalue">void</span> <a class="link" href="glib-String-Chunks.html#g-string-chunk-clear" title="g_string_chunk_clear ()">g_string_chunk_clear</a> (<em class="parameter"><code><a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a> *chunk</code></em>);
53
- <span class="returnvalue">void</span> <a class="link" href="glib-String-Chunks.html#g-string-chunk-free" title="g_string_chunk_free ()">g_string_chunk_free</a> (<em class="parameter"><code><a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a> *chunk</code></em>);
54
- </pre>
55
- </div>
56
- <div class="refsect1">
57
- <a name="glib-String-Chunks.description"></a><h2>Description</h2>
58
- <p>
59
- String chunks are used to store groups of strings. Memory is
60
- allocated in blocks, and as strings are added to the <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a>
61
- they are copied into the next free position in a block. When a block
62
- is full a new block is allocated.
63
- </p>
64
- <p>
65
- When storing a large number of strings, string chunks are more
66
- efficient than using <a class="link" href="glib-String-Utility-Functions.html#g-strdup" title="g_strdup ()"><code class="function">g_strdup()</code></a> since fewer calls to <code class="function">malloc()</code> are
67
- needed, and less memory is wasted in memory allocation overheads.
68
- </p>
69
- <p>
70
- By adding strings with <a class="link" href="glib-String-Chunks.html#g-string-chunk-insert-const" title="g_string_chunk_insert_const ()"><code class="function">g_string_chunk_insert_const()</code></a> it is also
71
- possible to remove duplicates.
72
- </p>
73
- <p>
74
- To create a new <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a> use <a class="link" href="glib-String-Chunks.html#g-string-chunk-new" title="g_string_chunk_new ()"><code class="function">g_string_chunk_new()</code></a>.
75
- </p>
76
- <p>
77
- To add strings to a <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a> use <a class="link" href="glib-String-Chunks.html#g-string-chunk-insert" title="g_string_chunk_insert ()"><code class="function">g_string_chunk_insert()</code></a>.
78
- </p>
79
- <p>
80
- To add strings to a <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a>, but without duplicating strings
81
- which are already in the <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a>, use
82
- <a class="link" href="glib-String-Chunks.html#g-string-chunk-insert-const" title="g_string_chunk_insert_const ()"><code class="function">g_string_chunk_insert_const()</code></a>.
83
- </p>
84
- <p>
85
- To free the entire <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a> use <a class="link" href="glib-String-Chunks.html#g-string-chunk-free" title="g_string_chunk_free ()"><code class="function">g_string_chunk_free()</code></a>. It is
86
- not possible to free individual strings.
87
- </p>
88
- </div>
89
- <div class="refsect1">
90
- <a name="glib-String-Chunks.details"></a><h2>Details</h2>
91
- <div class="refsect2">
92
- <a name="GStringChunk"></a><h3>GStringChunk</h3>
93
- <pre class="programlisting">typedef struct _GStringChunk GStringChunk;</pre>
94
- <p>
95
- An opaque data structure representing String Chunks. It should only
96
- be accessed by using the following functions.
97
- </p>
98
- </div>
99
- <hr>
100
- <div class="refsect2">
101
- <a name="g-string-chunk-new"></a><h3>g_string_chunk_new ()</h3>
102
- <pre class="programlisting"><a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="returnvalue">GStringChunk</span></a> * g_string_chunk_new (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> size</code></em>);</pre>
103
- <p>
104
- Creates a new <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a>.
105
- </p>
106
- <div class="variablelist"><table border="0">
107
- <col align="left" valign="top">
108
- <tbody>
109
- <tr>
110
- <td><p><span class="term"><em class="parameter"><code>size</code></em> :</span></p></td>
111
- <td>the default size of the blocks of memory which are
112
- allocated to store the strings. If a particular string
113
- is larger than this default size, a larger block of
114
- memory will be allocated for it.
115
- </td>
116
- </tr>
117
- <tr>
118
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
119
- <td> a new <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a>
120
- </td>
121
- </tr>
122
- </tbody>
123
- </table></div>
124
- </div>
125
- <hr>
126
- <div class="refsect2">
127
- <a name="g-string-chunk-insert"></a><h3>g_string_chunk_insert ()</h3>
128
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_string_chunk_insert (<em class="parameter"><code><a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a> *chunk</code></em>,
129
- <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>
130
- <p>
131
- Adds a copy of <em class="parameter"><code>string</code></em> to the <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a>.
132
- It returns a pointer to the new copy of the string
133
- in the <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a>. The characters in the string
134
- can be changed, if necessary, though you should not
135
- change anything after the end of the string.
136
- </p>
137
- <p>
138
- Unlike <a class="link" href="glib-String-Chunks.html#g-string-chunk-insert-const" title="g_string_chunk_insert_const ()"><code class="function">g_string_chunk_insert_const()</code></a>, this function
139
- does not check for duplicates. Also strings added
140
- with <a class="link" href="glib-String-Chunks.html#g-string-chunk-insert" title="g_string_chunk_insert ()"><code class="function">g_string_chunk_insert()</code></a> will not be searched
141
- by <a class="link" href="glib-String-Chunks.html#g-string-chunk-insert-const" title="g_string_chunk_insert_const ()"><code class="function">g_string_chunk_insert_const()</code></a> when looking for
142
- duplicates.
143
- </p>
144
- <div class="variablelist"><table border="0">
145
- <col align="left" valign="top">
146
- <tbody>
147
- <tr>
148
- <td><p><span class="term"><em class="parameter"><code>chunk</code></em> :</span></p></td>
149
- <td>a <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a>
150
- </td>
151
- </tr>
152
- <tr>
153
- <td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
154
- <td>the string to add
155
- </td>
156
- </tr>
157
- <tr>
158
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
159
- <td> a pointer to the copy of <em class="parameter"><code>string</code></em> within
160
- the <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a>
161
- </td>
162
- </tr>
163
- </tbody>
164
- </table></div>
165
- </div>
166
- <hr>
167
- <div class="refsect2">
168
- <a name="g-string-chunk-insert-const"></a><h3>g_string_chunk_insert_const ()</h3>
169
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_string_chunk_insert_const (<em class="parameter"><code><a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a> *chunk</code></em>,
170
- <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>
171
- <p>
172
- Adds a copy of <em class="parameter"><code>string</code></em> to the <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a>, unless the same
173
- string has already been added to the <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a> with
174
- <a class="link" href="glib-String-Chunks.html#g-string-chunk-insert-const" title="g_string_chunk_insert_const ()"><code class="function">g_string_chunk_insert_const()</code></a>.
175
- </p>
176
- <p>
177
- This function is useful if you need to copy a large number
178
- of strings but do not want to waste space storing duplicates.
179
- But you must remember that there may be several pointers to
180
- the same string, and so any changes made to the strings
181
- should be done very carefully.
182
- </p>
183
- <p>
184
- Note that <a class="link" href="glib-String-Chunks.html#g-string-chunk-insert-const" title="g_string_chunk_insert_const ()"><code class="function">g_string_chunk_insert_const()</code></a> will not return a
185
- pointer to a string added with <a class="link" href="glib-String-Chunks.html#g-string-chunk-insert" title="g_string_chunk_insert ()"><code class="function">g_string_chunk_insert()</code></a>, even
186
- if they do match.
187
- </p>
188
- <div class="variablelist"><table border="0">
189
- <col align="left" valign="top">
190
- <tbody>
191
- <tr>
192
- <td><p><span class="term"><em class="parameter"><code>chunk</code></em> :</span></p></td>
193
- <td>a <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a>
194
- </td>
195
- </tr>
196
- <tr>
197
- <td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
198
- <td>the string to add
199
- </td>
200
- </tr>
201
- <tr>
202
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
203
- <td> a pointer to the new or existing copy of <em class="parameter"><code>string</code></em>
204
- within the <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a>
205
- </td>
206
- </tr>
207
- </tbody>
208
- </table></div>
209
- </div>
210
- <hr>
211
- <div class="refsect2">
212
- <a name="g-string-chunk-insert-len"></a><h3>g_string_chunk_insert_len ()</h3>
213
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_string_chunk_insert_len (<em class="parameter"><code><a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a> *chunk</code></em>,
214
- <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>,
215
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> len</code></em>);</pre>
216
- <p>
217
- Adds a copy of the first <em class="parameter"><code>len</code></em> bytes of <em class="parameter"><code>string</code></em> to the <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a>.
218
- The copy is nul-terminated.
219
- </p>
220
- <p>
221
- Since this function does not stop at nul bytes, it is the caller's
222
- responsibility to ensure that <em class="parameter"><code>string</code></em> has at least <em class="parameter"><code>len</code></em> addressable
223
- bytes.
224
- </p>
225
- <p>
226
- The characters in the returned string can be changed, if necessary,
227
- though you should not change anything after the end of the string.
228
- </p>
229
- <div class="variablelist"><table border="0">
230
- <col align="left" valign="top">
231
- <tbody>
232
- <tr>
233
- <td><p><span class="term"><em class="parameter"><code>chunk</code></em> :</span></p></td>
234
- <td>a <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a>
235
- </td>
236
- </tr>
237
- <tr>
238
- <td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
239
- <td>bytes to insert
240
- </td>
241
- </tr>
242
- <tr>
243
- <td><p><span class="term"><em class="parameter"><code>len</code></em> :</span></p></td>
244
- <td>number of bytes of <em class="parameter"><code>string</code></em> to insert, or -1 to insert a
245
- nul-terminated string
246
- </td>
247
- </tr>
248
- <tr>
249
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
250
- <td> a pointer to the copy of <em class="parameter"><code>string</code></em> within the <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a>
251
-
252
- </td>
253
- </tr>
254
- </tbody>
255
- </table></div>
256
- <p class="since">Since 2.4</p>
257
- </div>
258
- <hr>
259
- <div class="refsect2">
260
- <a name="g-string-chunk-clear"></a><h3>g_string_chunk_clear ()</h3>
261
- <pre class="programlisting"><span class="returnvalue">void</span> g_string_chunk_clear (<em class="parameter"><code><a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a> *chunk</code></em>);</pre>
262
- <p>
263
- Frees all strings contained within the <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a>.
264
- After calling <a class="link" href="glib-String-Chunks.html#g-string-chunk-clear" title="g_string_chunk_clear ()"><code class="function">g_string_chunk_clear()</code></a> it is not safe to
265
- access any of the strings which were contained within it.
266
- </p>
267
- <div class="variablelist"><table border="0">
268
- <col align="left" valign="top">
269
- <tbody><tr>
270
- <td><p><span class="term"><em class="parameter"><code>chunk</code></em> :</span></p></td>
271
- <td>a <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a>
272
- </td>
273
- </tr></tbody>
274
- </table></div>
275
- <p class="since">Since 2.14</p>
276
- </div>
277
- <hr>
278
- <div class="refsect2">
279
- <a name="g-string-chunk-free"></a><h3>g_string_chunk_free ()</h3>
280
- <pre class="programlisting"><span class="returnvalue">void</span> g_string_chunk_free (<em class="parameter"><code><a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a> *chunk</code></em>);</pre>
281
- <p>
282
- Frees all memory allocated by the <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a>.
283
- After calling <a class="link" href="glib-String-Chunks.html#g-string-chunk-free" title="g_string_chunk_free ()"><code class="function">g_string_chunk_free()</code></a> it is not safe to
284
- access any of the strings which were contained within it.
285
- </p>
286
- <div class="variablelist"><table border="0">
287
- <col align="left" valign="top">
288
- <tbody><tr>
289
- <td><p><span class="term"><em class="parameter"><code>chunk</code></em> :</span></p></td>
290
- <td>a <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a>
291
- </td>
292
- </tr></tbody>
293
- </table></div>
294
- </div>
295
- </div>
296
- </div>
297
- <div class="footer">
298
- <hr>
299
- Generated by GTK-Doc V1.15.1</div>
300
- </body>
301
- </html>
data/vendor/local/share/gtk-doc/html/glib/glib-String-Utility-Functions.html DELETED
@@ -1,2960 +0,0 @@
1
- <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
- <html>
3
- <head>
4
- <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
- <title>String Utility Functions</title>
6
- <meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
7
- <link rel="home" href="index.html" title="GLib Reference Manual">
8
- <link rel="up" href="glib-utilities.html" title="GLib Utilities">
9
- <link rel="prev" href="glib-utilities.html" title="GLib Utilities">
10
- <link rel="next" href="glib-Character-Set-Conversion.html" title="Character Set Conversion">
11
- <meta name="generator" content="GTK-Doc V1.15.1 (XML mode)">
12
- <link rel="stylesheet" href="style.css" type="text/css">
13
- </head>
14
- <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
- <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
16
- <tr valign="middle">
17
- <td><a accesskey="p" href="glib-utilities.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18
- <td><a accesskey="u" href="glib-utilities.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19
- <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20
- <th width="100%" align="center">GLib Reference Manual</th>
21
- <td><a accesskey="n" href="glib-Character-Set-Conversion.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-String-Utility-Functions.synopsis" class="shortcut">Top</a>
25
-  | 
26
- <a href="#glib-String-Utility-Functions.description" class="shortcut">Description</a>
27
- </td></tr>
28
- </table>
29
- <div class="refentry">
30
- <a name="glib-String-Utility-Functions"></a><div class="titlepage"></div>
31
- <div class="refnamediv"><table width="100%"><tr>
32
- <td valign="top">
33
- <h2><span class="refentrytitle"><a name="glib-String-Utility-Functions.top_of_page"></a>String Utility Functions</span></h2>
34
- <p>String Utility Functions — various string-related functions</p>
35
- </td>
36
- <td valign="top" align="right"></td>
37
- </tr></table></div>
38
- <div class="refsynopsisdiv">
39
- <a name="glib-String-Utility-Functions.synopsis"></a><h2>Synopsis</h2>
40
- <pre class="synopsis">
41
- #include &lt;glib.h&gt;
42
- #include &lt;glib/gprintf.h&gt;
43
-
44
- <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-String-Utility-Functions.html#g-strdup" title="g_strdup ()">g_strdup</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>);
45
- <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-String-Utility-Functions.html#g-strndup" title="g_strndup ()">g_strndup</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
46
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> n</code></em>);
47
- <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> ** <a class="link" href="glib-String-Utility-Functions.html#g-strdupv" title="g_strdupv ()">g_strdupv</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **str_array</code></em>);
48
- <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-String-Utility-Functions.html#g-strnfill" title="g_strnfill ()">g_strnfill</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> length</code></em>,
49
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> fill_char</code></em>);
50
- <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-String-Utility-Functions.html#g-stpcpy" title="g_stpcpy ()">g_stpcpy</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *dest</code></em>,
51
- <em class="parameter"><code>const <span class="type">char</span> *src</code></em>);
52
- <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-String-Utility-Functions.html#g-strstr-len" title="g_strstr_len ()">g_strstr_len</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *haystack</code></em>,
53
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> haystack_len</code></em>,
54
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *needle</code></em>);
55
- <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-String-Utility-Functions.html#g-strrstr" title="g_strrstr ()">g_strrstr</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *haystack</code></em>,
56
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *needle</code></em>);
57
- <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-String-Utility-Functions.html#g-strrstr-len" title="g_strrstr_len ()">g_strrstr_len</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *haystack</code></em>,
58
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> haystack_len</code></em>,
59
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *needle</code></em>);
60
- <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-String-Utility-Functions.html#g-str-has-prefix" title="g_str_has_prefix ()">g_str_has_prefix</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
61
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *prefix</code></em>);
62
- <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-String-Utility-Functions.html#g-str-has-suffix" title="g_str_has_suffix ()">g_str_has_suffix</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
63
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *suffix</code></em>);
64
- <span class="returnvalue">int</span> <a class="link" href="glib-String-Utility-Functions.html#g-strcmp0" title="g_strcmp0 ()">g_strcmp0</a> (<em class="parameter"><code>const <span class="type">char</span> *str1</code></em>,
65
- <em class="parameter"><code>const <span class="type">char</span> *str2</code></em>);
66
-
67
- <a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="returnvalue">gsize</span></a> <a class="link" href="glib-String-Utility-Functions.html#g-strlcpy" title="g_strlcpy ()">g_strlcpy</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *dest</code></em>,
68
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *src</code></em>,
69
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> dest_size</code></em>);
70
- <a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="returnvalue">gsize</span></a> <a class="link" href="glib-String-Utility-Functions.html#g-strlcat" title="g_strlcat ()">g_strlcat</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *dest</code></em>,
71
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *src</code></em>,
72
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> dest_size</code></em>);
73
-
74
- <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-String-Utility-Functions.html#g-strdup-printf" title="g_strdup_printf ()">g_strdup_printf</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>,
75
- <em class="parameter"><code>...</code></em>);
76
- <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-String-Utility-Functions.html#g-strdup-vprintf" title="g_strdup_vprintf ()">g_strdup_vprintf</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>,
77
- <em class="parameter"><code><span class="type">va_list</span> args</code></em>);
78
- <a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> <a class="link" href="glib-String-Utility-Functions.html#g-printf" title="g_printf ()">g_printf</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> const *format</code></em>,
79
- <em class="parameter"><code>...</code></em>);
80
- <a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> <a class="link" href="glib-String-Utility-Functions.html#g-vprintf" title="g_vprintf ()">g_vprintf</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> const *format</code></em>,
81
- <em class="parameter"><code><span class="type">va_list</span> args</code></em>);
82
- <a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> <a class="link" href="glib-String-Utility-Functions.html#g-fprintf" title="g_fprintf ()">g_fprintf</a> (<em class="parameter"><code><span class="type">FILE</span> *file</code></em>,
83
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> const *format</code></em>,
84
- <em class="parameter"><code>...</code></em>);
85
- <a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> <a class="link" href="glib-String-Utility-Functions.html#g-vfprintf" title="g_vfprintf ()">g_vfprintf</a> (<em class="parameter"><code><span class="type">FILE</span> *file</code></em>,
86
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> const *format</code></em>,
87
- <em class="parameter"><code><span class="type">va_list</span> args</code></em>);
88
- <a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> <a class="link" href="glib-String-Utility-Functions.html#g-sprintf" title="g_sprintf ()">g_sprintf</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *string</code></em>,
89
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> const *format</code></em>,
90
- <em class="parameter"><code>...</code></em>);
91
- <a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> <a class="link" href="glib-String-Utility-Functions.html#g-vsprintf" title="g_vsprintf ()">g_vsprintf</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *string</code></em>,
92
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> const *format</code></em>,
93
- <em class="parameter"><code><span class="type">va_list</span> args</code></em>);
94
- <a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> <a class="link" href="glib-String-Utility-Functions.html#g-snprintf" title="g_snprintf ()">g_snprintf</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *string</code></em>,
95
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gulong" title="gulong"><span class="type">gulong</span></a> n</code></em>,
96
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> const *format</code></em>,
97
- <em class="parameter"><code>...</code></em>);
98
- <a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> <a class="link" href="glib-String-Utility-Functions.html#g-vsnprintf" title="g_vsnprintf ()">g_vsnprintf</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *string</code></em>,
99
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gulong" title="gulong"><span class="type">gulong</span></a> n</code></em>,
100
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> const *format</code></em>,
101
- <em class="parameter"><code><span class="type">va_list</span> args</code></em>);
102
- <a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> <a class="link" href="glib-String-Utility-Functions.html#g-vasprintf" title="g_vasprintf ()">g_vasprintf</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **string</code></em>,
103
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> const *format</code></em>,
104
- <em class="parameter"><code><span class="type">va_list</span> args</code></em>);
105
- <a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="returnvalue">gsize</span></a> <a class="link" href="glib-String-Utility-Functions.html#g-printf-string-upper-bound" title="g_printf_string_upper_bound ()">g_printf_string_upper_bound</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>,
106
- <em class="parameter"><code><span class="type">va_list</span> args</code></em>);
107
-
108
- <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-String-Utility-Functions.html#g-ascii-isalnum" title="g_ascii_isalnum ()">g_ascii_isalnum</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> c</code></em>);
109
- <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-String-Utility-Functions.html#g-ascii-isalpha" title="g_ascii_isalpha ()">g_ascii_isalpha</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> c</code></em>);
110
- <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-String-Utility-Functions.html#g-ascii-iscntrl" title="g_ascii_iscntrl ()">g_ascii_iscntrl</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> c</code></em>);
111
- <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-String-Utility-Functions.html#g-ascii-isdigit" title="g_ascii_isdigit ()">g_ascii_isdigit</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> c</code></em>);
112
- <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-String-Utility-Functions.html#g-ascii-isgraph" title="g_ascii_isgraph ()">g_ascii_isgraph</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> c</code></em>);
113
- <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-String-Utility-Functions.html#g-ascii-islower" title="g_ascii_islower ()">g_ascii_islower</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> c</code></em>);
114
- <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-String-Utility-Functions.html#g-ascii-isprint" title="g_ascii_isprint ()">g_ascii_isprint</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> c</code></em>);
115
- <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-String-Utility-Functions.html#g-ascii-ispunct" title="g_ascii_ispunct ()">g_ascii_ispunct</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> c</code></em>);
116
- <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-String-Utility-Functions.html#g-ascii-isspace" title="g_ascii_isspace ()">g_ascii_isspace</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> c</code></em>);
117
- <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-String-Utility-Functions.html#g-ascii-isupper" title="g_ascii_isupper ()">g_ascii_isupper</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> c</code></em>);
118
- <a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-String-Utility-Functions.html#g-ascii-isxdigit" title="g_ascii_isxdigit ()">g_ascii_isxdigit</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> c</code></em>);
119
-
120
- <a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> <a class="link" href="glib-String-Utility-Functions.html#g-ascii-digit-value" title="g_ascii_digit_value ()">g_ascii_digit_value</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> c</code></em>);
121
- <a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> <a class="link" href="glib-String-Utility-Functions.html#g-ascii-xdigit-value" title="g_ascii_xdigit_value ()">g_ascii_xdigit_value</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> c</code></em>);
122
-
123
- <a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> <a class="link" href="glib-String-Utility-Functions.html#g-ascii-strcasecmp" title="g_ascii_strcasecmp ()">g_ascii_strcasecmp</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *s1</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> *s2</code></em>);
125
- <a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> <a class="link" href="glib-String-Utility-Functions.html#g-ascii-strncasecmp" title="g_ascii_strncasecmp ()">g_ascii_strncasecmp</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *s1</code></em>,
126
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *s2</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</code></em>);
128
-
129
- <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-String-Utility-Functions.html#g-ascii-strup" title="g_ascii_strup ()">g_ascii_strup</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
130
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> len</code></em>);
131
- <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-String-Utility-Functions.html#g-ascii-strdown" title="g_ascii_strdown ()">g_ascii_strdown</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
132
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> len</code></em>);
133
-
134
- <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> <a class="link" href="glib-String-Utility-Functions.html#g-ascii-tolower" title="g_ascii_tolower ()">g_ascii_tolower</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> c</code></em>);
135
- <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> <a class="link" href="glib-String-Utility-Functions.html#g-ascii-toupper" title="g_ascii_toupper ()">g_ascii_toupper</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> c</code></em>);
136
-
137
- <a class="link" href="glib-Strings.html#GString" title="GString"><span class="returnvalue">GString</span></a> * <a class="link" href="glib-String-Utility-Functions.html#g-string-ascii-up" title="g_string_ascii_up ()">g_string_ascii_up</a> (<em class="parameter"><code><a class="link" href="glib-Strings.html#GString" title="GString"><span class="type">GString</span></a> *string</code></em>);
138
- <a class="link" href="glib-Strings.html#GString" title="GString"><span class="returnvalue">GString</span></a> * <a class="link" href="glib-String-Utility-Functions.html#g-string-ascii-down" title="g_string_ascii_down ()">g_string_ascii_down</a> (<em class="parameter"><code><a class="link" href="glib-Strings.html#GString" title="GString"><span class="type">GString</span></a> *string</code></em>);
139
-
140
- <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-String-Utility-Functions.html#g-strup" title="g_strup ()">g_strup</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *string</code></em>);
141
- <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-String-Utility-Functions.html#g-strdown" title="g_strdown ()">g_strdown</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *string</code></em>);
142
-
143
- <a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> <a class="link" href="glib-String-Utility-Functions.html#g-strcasecmp" title="g_strcasecmp ()">g_strcasecmp</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *s1</code></em>,
144
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *s2</code></em>);
145
- <a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> <a class="link" href="glib-String-Utility-Functions.html#g-strncasecmp" title="g_strncasecmp ()">g_strncasecmp</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *s1</code></em>,
146
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *s2</code></em>,
147
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="type">guint</span></a> n</code></em>);
148
-
149
- <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-String-Utility-Functions.html#g-strreverse" title="g_strreverse ()">g_strreverse</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *string</code></em>);
150
-
151
- <a class="link" href="glib-Basic-Types.html#gint64" title="gint64"><span class="returnvalue">gint64</span></a> <a class="link" href="glib-String-Utility-Functions.html#g-ascii-strtoll" title="g_ascii_strtoll ()">g_ascii_strtoll</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *nptr</code></em>,
152
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **endptr</code></em>,
153
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="type">guint</span></a> base</code></em>);
154
- <a class="link" href="glib-Basic-Types.html#guint64" title="guint64"><span class="returnvalue">guint64</span></a> <a class="link" href="glib-String-Utility-Functions.html#g-ascii-strtoull" title="g_ascii_strtoull ()">g_ascii_strtoull</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *nptr</code></em>,
155
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **endptr</code></em>,
156
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="type">guint</span></a> base</code></em>);
157
- #define <a class="link" href="glib-String-Utility-Functions.html#G-ASCII-DTOSTR-BUF-SIZE:CAPS" title="G_ASCII_DTOSTR_BUF_SIZE">G_ASCII_DTOSTR_BUF_SIZE</a>
158
- <a class="link" href="glib-Basic-Types.html#gdouble" title="gdouble"><span class="returnvalue">gdouble</span></a> <a class="link" href="glib-String-Utility-Functions.html#g-ascii-strtod" title="g_ascii_strtod ()">g_ascii_strtod</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *nptr</code></em>,
159
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **endptr</code></em>);
160
- <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-String-Utility-Functions.html#g-ascii-dtostr" title="g_ascii_dtostr ()">g_ascii_dtostr</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *buffer</code></em>,
161
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> buf_len</code></em>,
162
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gdouble" title="gdouble"><span class="type">gdouble</span></a> d</code></em>);
163
- <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-String-Utility-Functions.html#g-ascii-formatd" title="g_ascii_formatd ()">g_ascii_formatd</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *buffer</code></em>,
164
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> buf_len</code></em>,
165
- <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>,
166
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gdouble" title="gdouble"><span class="type">gdouble</span></a> d</code></em>);
167
- <a class="link" href="glib-Basic-Types.html#gdouble" title="gdouble"><span class="returnvalue">gdouble</span></a> <a class="link" href="glib-String-Utility-Functions.html#g-strtod" title="g_strtod ()">g_strtod</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *nptr</code></em>,
168
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **endptr</code></em>);
169
-
170
- <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-String-Utility-Functions.html#g-strchug" title="g_strchug ()">g_strchug</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *string</code></em>);
171
- <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-String-Utility-Functions.html#g-strchomp" title="g_strchomp ()">g_strchomp</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *string</code></em>);
172
- #define <a class="link" href="glib-String-Utility-Functions.html#g-strstrip" title="g_strstrip()">g_strstrip</a> (string)
173
-
174
- <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-String-Utility-Functions.html#g-strdelimit" title="g_strdelimit ()">g_strdelimit</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *string</code></em>,
175
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *delimiters</code></em>,
176
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> new_delimiter</code></em>);
177
- #define <a class="link" href="glib-String-Utility-Functions.html#G-STR-DELIMITERS:CAPS" title="G_STR_DELIMITERS">G_STR_DELIMITERS</a>
178
- <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-String-Utility-Functions.html#g-strescape" title="g_strescape ()">g_strescape</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *source</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> *exceptions</code></em>);
180
- <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-String-Utility-Functions.html#g-strcompress" title="g_strcompress ()">g_strcompress</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *source</code></em>);
181
- <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-String-Utility-Functions.html#g-strcanon" title="g_strcanon ()">g_strcanon</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *string</code></em>,
182
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *valid_chars</code></em>,
183
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> substitutor</code></em>);
184
- <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> ** <a class="link" href="glib-String-Utility-Functions.html#g-strsplit" title="g_strsplit ()">g_strsplit</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>,
185
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *delimiter</code></em>,
186
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> max_tokens</code></em>);
187
- <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> ** <a class="link" href="glib-String-Utility-Functions.html#g-strsplit-set" title="g_strsplit_set ()">g_strsplit_set</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>,
188
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *delimiters</code></em>,
189
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> max_tokens</code></em>);
190
- <span class="returnvalue">void</span> <a class="link" href="glib-String-Utility-Functions.html#g-strfreev" title="g_strfreev ()">g_strfreev</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **str_array</code></em>);
191
- <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-String-Utility-Functions.html#g-strconcat" title="g_strconcat ()">g_strconcat</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *string1</code></em>,
192
- <em class="parameter"><code>...</code></em>);
193
- <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-String-Utility-Functions.html#g-strjoin" title="g_strjoin ()">g_strjoin</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *separator</code></em>,
194
- <em class="parameter"><code>...</code></em>);
195
- <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-String-Utility-Functions.html#g-strjoinv" title="g_strjoinv ()">g_strjoinv</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *separator</code></em>,
196
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **str_array</code></em>);
197
- <a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="returnvalue">guint</span></a> <a class="link" href="glib-String-Utility-Functions.html#g-strv-length" title="g_strv_length ()">g_strv_length</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **str_array</code></em>);
198
-
199
- const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-String-Utility-Functions.html#g-strerror" title="g_strerror ()">g_strerror</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> errnum</code></em>);
200
- const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-String-Utility-Functions.html#g-strsignal" title="g_strsignal ()">g_strsignal</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> signum</code></em>);
201
- </pre>
202
- </div>
203
- <div class="refsect1">
204
- <a name="glib-String-Utility-Functions.description"></a><h2>Description</h2>
205
- <p>
206
- This section describes a number of utility functions for creating,
207
- duplicating, and manipulating strings.
208
- </p>
209
- <p>
210
- Note that the functions <a class="link" href="glib-String-Utility-Functions.html#g-printf" title="g_printf ()"><code class="function">g_printf()</code></a>, <a class="link" href="glib-String-Utility-Functions.html#g-fprintf" title="g_fprintf ()"><code class="function">g_fprintf()</code></a>, <a class="link" href="glib-String-Utility-Functions.html#g-sprintf" title="g_sprintf ()"><code class="function">g_sprintf()</code></a>, <a class="link" href="glib-String-Utility-Functions.html#g-snprintf" title="g_snprintf ()"><code class="function">g_snprintf()</code></a>,
211
- <a class="link" href="glib-String-Utility-Functions.html#g-vprintf" title="g_vprintf ()"><code class="function">g_vprintf()</code></a>, <a class="link" href="glib-String-Utility-Functions.html#g-vfprintf" title="g_vfprintf ()"><code class="function">g_vfprintf()</code></a>, <a class="link" href="glib-String-Utility-Functions.html#g-vsprintf" title="g_vsprintf ()"><code class="function">g_vsprintf()</code></a> and <a class="link" href="glib-String-Utility-Functions.html#g-vsnprintf" title="g_vsnprintf ()"><code class="function">g_vsnprintf()</code></a> are declared in
212
- the header <code class="filename">gprintf.h</code> which is <span class="emphasis"><em>not</em></span>
213
- included in <code class="filename">glib.h</code> (otherwise using
214
- <code class="filename">glib.h</code> would drag in <code class="filename">stdio.h</code>), so
215
- you'll have to explicitly include <code class="literal">&lt;glib/gprintf.h&gt;</code>
216
- in order to use the GLib <code class="function">printf()</code> functions.
217
- </p>
218
- <p><a name="string-precision"></a>
219
- While you may use the <code class="function">printf()</code> functions to format UTF-8 strings, notice that
220
- the precision of a <code class="literal">%Ns</code> parameter is interpreted as the
221
- number of <span class="emphasis"><em>bytes</em></span>, not <span class="emphasis"><em>characters</em></span> to print.
222
- On top of that, the GNU libc implementation of the <code class="function">printf()</code> functions has the "feature"
223
- that it checks that the string given for the <code class="literal">%Ns</code> parameter
224
- consists of a whole number of characters in the current encoding. So, unless you
225
- are sure you are always going to be in an UTF-8 locale or your know your text is restricted
226
- to ASCII, avoid using <code class="literal">%Ns</code>.
227
- If your intention is to format strings for a certain number of columns, then
228
- <code class="literal">%Ns</code> is not a correct solution anyway, since it fails to take
229
- wide characters (see <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-iswide" title="g_unichar_iswide ()"><code class="function">g_unichar_iswide()</code></a>) into account.
230
- </p>
231
- </div>
232
- <div class="refsect1">
233
- <a name="glib-String-Utility-Functions.details"></a><h2>Details</h2>
234
- <div class="refsect2">
235
- <a name="g-strdup"></a><h3>g_strdup ()</h3>
236
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_strdup (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>);</pre>
237
- <p>
238
- Duplicates a string. If <em class="parameter"><code>str</code></em> is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> it returns <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
239
- The returned string should be freed with <a class="link" href="glib-Memory-Allocation.html#g-free" title="g_free ()"><code class="function">g_free()</code></a>
240
- when no longer needed.
241
- </p>
242
- <div class="variablelist"><table border="0">
243
- <col align="left" valign="top">
244
- <tbody>
245
- <tr>
246
- <td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
247
- <td>the string to duplicate
248
- </td>
249
- </tr>
250
- <tr>
251
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
252
- <td> a newly-allocated copy of <em class="parameter"><code>str</code></em>
253
- </td>
254
- </tr>
255
- </tbody>
256
- </table></div>
257
- </div>
258
- <hr>
259
- <div class="refsect2">
260
- <a name="g-strndup"></a><h3>g_strndup ()</h3>
261
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_strndup (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
262
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> n</code></em>);</pre>
263
- <p>
264
- Duplicates the first <em class="parameter"><code>n</code></em> bytes of a string, returning a newly-allocated
265
- buffer <em class="parameter"><code>n</code></em> + 1 bytes long which will always be nul-terminated.
266
- If <em class="parameter"><code>str</code></em> is less than <em class="parameter"><code>n</code></em> bytes long the buffer is padded with nuls.
267
- If <em class="parameter"><code>str</code></em> is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> it returns <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
268
- The returned value should be freed when no longer needed.
269
- </p>
270
- <p>
271
- </p>
272
- <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
273
- <h3 class="title">Note</h3>
274
- <p>
275
- To copy a number of characters from a UTF-8 encoded string, use
276
- <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-strncpy" title="g_utf8_strncpy ()"><code class="function">g_utf8_strncpy()</code></a> instead.
277
- </p>
278
- </div>
279
- <p>
280
- </p>
281
- <div class="variablelist"><table border="0">
282
- <col align="left" valign="top">
283
- <tbody>
284
- <tr>
285
- <td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
286
- <td>the string to duplicate
287
- </td>
288
- </tr>
289
- <tr>
290
- <td><p><span class="term"><em class="parameter"><code>n</code></em> :</span></p></td>
291
- <td>the maximum number of bytes to copy from <em class="parameter"><code>str</code></em>
292
- </td>
293
- </tr>
294
- <tr>
295
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
296
- <td> a newly-allocated buffer containing the first <em class="parameter"><code>n</code></em> bytes
297
- of <em class="parameter"><code>str</code></em>, nul-terminated
298
- </td>
299
- </tr>
300
- </tbody>
301
- </table></div>
302
- </div>
303
- <hr>
304
- <div class="refsect2">
305
- <a name="g-strdupv"></a><h3>g_strdupv ()</h3>
306
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> ** g_strdupv (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **str_array</code></em>);</pre>
307
- <p>
308
- Copies <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated array of strings. The copy is a deep copy;
309
- the new array should be freed by first freeing each string, then
310
- the array itself. <a class="link" href="glib-String-Utility-Functions.html#g-strfreev" title="g_strfreev ()"><code class="function">g_strfreev()</code></a> does this for you. If called
311
- on a <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> value, <a class="link" href="glib-String-Utility-Functions.html#g-strdupv" title="g_strdupv ()"><code class="function">g_strdupv()</code></a> simply returns <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
312
- </p>
313
- <div class="variablelist"><table border="0">
314
- <col align="left" valign="top">
315
- <tbody>
316
- <tr>
317
- <td><p><span class="term"><em class="parameter"><code>str_array</code></em> :</span></p></td>
318
- <td>
319
- <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated array of strings.
320
- </td>
321
- </tr>
322
- <tr>
323
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
324
- <td> a new <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated array of strings.
325
- </td>
326
- </tr>
327
- </tbody>
328
- </table></div>
329
- </div>
330
- <hr>
331
- <div class="refsect2">
332
- <a name="g-strnfill"></a><h3>g_strnfill ()</h3>
333
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_strnfill (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> length</code></em>,
334
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> fill_char</code></em>);</pre>
335
- <p>
336
- Creates a new string <em class="parameter"><code>length</code></em> bytes long filled with <em class="parameter"><code>fill_char</code></em>.
337
- The returned string should be freed when no longer needed.
338
- </p>
339
- <div class="variablelist"><table border="0">
340
- <col align="left" valign="top">
341
- <tbody>
342
- <tr>
343
- <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
344
- <td>the length of the new string
345
- </td>
346
- </tr>
347
- <tr>
348
- <td><p><span class="term"><em class="parameter"><code>fill_char</code></em> :</span></p></td>
349
- <td>the byte to fill the string with
350
- </td>
351
- </tr>
352
- <tr>
353
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
354
- <td> a newly-allocated string filled the <em class="parameter"><code>fill_char</code></em>
355
- </td>
356
- </tr>
357
- </tbody>
358
- </table></div>
359
- </div>
360
- <hr>
361
- <div class="refsect2">
362
- <a name="g-stpcpy"></a><h3>g_stpcpy ()</h3>
363
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_stpcpy (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *dest</code></em>,
364
- <em class="parameter"><code>const <span class="type">char</span> *src</code></em>);</pre>
365
- <p>
366
- Copies a nul-terminated string into the dest buffer, include the
367
- trailing nul, and return a pointer to the trailing nul byte.
368
- This is useful for concatenating multiple strings together
369
- without having to repeatedly scan for the end.
370
- </p>
371
- <div class="variablelist"><table border="0">
372
- <col align="left" valign="top">
373
- <tbody>
374
- <tr>
375
- <td><p><span class="term"><em class="parameter"><code>dest</code></em> :</span></p></td>
376
- <td>destination buffer.
377
- </td>
378
- </tr>
379
- <tr>
380
- <td><p><span class="term"><em class="parameter"><code>src</code></em> :</span></p></td>
381
- <td>source string.
382
- </td>
383
- </tr>
384
- <tr>
385
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
386
- <td> a pointer to trailing nul byte.
387
- </td>
388
- </tr>
389
- </tbody>
390
- </table></div>
391
- </div>
392
- <hr>
393
- <div class="refsect2">
394
- <a name="g-strstr-len"></a><h3>g_strstr_len ()</h3>
395
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_strstr_len (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *haystack</code></em>,
396
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> haystack_len</code></em>,
397
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *needle</code></em>);</pre>
398
- <p>
399
- Searches the string <em class="parameter"><code>haystack</code></em> for the first occurrence
400
- of the string <em class="parameter"><code>needle</code></em>, limiting the length of the search
401
- to <em class="parameter"><code>haystack_len</code></em>.
402
- </p>
403
- <div class="variablelist"><table border="0">
404
- <col align="left" valign="top">
405
- <tbody>
406
- <tr>
407
- <td><p><span class="term"><em class="parameter"><code>haystack</code></em> :</span></p></td>
408
- <td>a string.
409
- </td>
410
- </tr>
411
- <tr>
412
- <td><p><span class="term"><em class="parameter"><code>haystack_len</code></em> :</span></p></td>
413
- <td>the maximum length of <em class="parameter"><code>haystack</code></em>. Note that -1 is
414
- a valid length, if <em class="parameter"><code>haystack</code></em> is nul-terminated, meaning it will
415
- search through the whole string.
416
- </td>
417
- </tr>
418
- <tr>
419
- <td><p><span class="term"><em class="parameter"><code>needle</code></em> :</span></p></td>
420
- <td>the string to search for.
421
- </td>
422
- </tr>
423
- <tr>
424
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
425
- <td> a pointer to the found occurrence, or
426
- <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if not found.
427
- </td>
428
- </tr>
429
- </tbody>
430
- </table></div>
431
- </div>
432
- <hr>
433
- <div class="refsect2">
434
- <a name="g-strrstr"></a><h3>g_strrstr ()</h3>
435
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_strrstr (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *haystack</code></em>,
436
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *needle</code></em>);</pre>
437
- <p>
438
- Searches the string <em class="parameter"><code>haystack</code></em> for the last occurrence
439
- of the string <em class="parameter"><code>needle</code></em>.
440
- </p>
441
- <div class="variablelist"><table border="0">
442
- <col align="left" valign="top">
443
- <tbody>
444
- <tr>
445
- <td><p><span class="term"><em class="parameter"><code>haystack</code></em> :</span></p></td>
446
- <td>a nul-terminated string.
447
- </td>
448
- </tr>
449
- <tr>
450
- <td><p><span class="term"><em class="parameter"><code>needle</code></em> :</span></p></td>
451
- <td>the nul-terminated string to search for.
452
- </td>
453
- </tr>
454
- <tr>
455
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
456
- <td> a pointer to the found occurrence, or
457
- <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if not found.
458
- </td>
459
- </tr>
460
- </tbody>
461
- </table></div>
462
- </div>
463
- <hr>
464
- <div class="refsect2">
465
- <a name="g-strrstr-len"></a><h3>g_strrstr_len ()</h3>
466
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_strrstr_len (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *haystack</code></em>,
467
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> haystack_len</code></em>,
468
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *needle</code></em>);</pre>
469
- <p>
470
- Searches the string <em class="parameter"><code>haystack</code></em> for the last occurrence
471
- of the string <em class="parameter"><code>needle</code></em>, limiting the length of the search
472
- to <em class="parameter"><code>haystack_len</code></em>.
473
- </p>
474
- <div class="variablelist"><table border="0">
475
- <col align="left" valign="top">
476
- <tbody>
477
- <tr>
478
- <td><p><span class="term"><em class="parameter"><code>haystack</code></em> :</span></p></td>
479
- <td>a nul-terminated string.
480
- </td>
481
- </tr>
482
- <tr>
483
- <td><p><span class="term"><em class="parameter"><code>haystack_len</code></em> :</span></p></td>
484
- <td>the maximum length of <em class="parameter"><code>haystack</code></em>.
485
- </td>
486
- </tr>
487
- <tr>
488
- <td><p><span class="term"><em class="parameter"><code>needle</code></em> :</span></p></td>
489
- <td>the nul-terminated string to search for.
490
- </td>
491
- </tr>
492
- <tr>
493
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
494
- <td> a pointer to the found occurrence, or
495
- <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if not found.
496
- </td>
497
- </tr>
498
- </tbody>
499
- </table></div>
500
- </div>
501
- <hr>
502
- <div class="refsect2">
503
- <a name="g-str-has-prefix"></a><h3>g_str_has_prefix ()</h3>
504
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_str_has_prefix (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
505
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *prefix</code></em>);</pre>
506
- <p>
507
- Looks whether the string <em class="parameter"><code>str</code></em> begins with <em class="parameter"><code>prefix</code></em>.
508
- </p>
509
- <div class="variablelist"><table border="0">
510
- <col align="left" valign="top">
511
- <tbody>
512
- <tr>
513
- <td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
514
- <td>a nul-terminated string.
515
- </td>
516
- </tr>
517
- <tr>
518
- <td><p><span class="term"><em class="parameter"><code>prefix</code></em> :</span></p></td>
519
- <td>the nul-terminated prefix to look for.
520
- </td>
521
- </tr>
522
- <tr>
523
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
524
- <td> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if <em class="parameter"><code>str</code></em> begins with <em class="parameter"><code>prefix</code></em>, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> otherwise.
525
-
526
- </td>
527
- </tr>
528
- </tbody>
529
- </table></div>
530
- <p class="since">Since 2.2</p>
531
- </div>
532
- <hr>
533
- <div class="refsect2">
534
- <a name="g-str-has-suffix"></a><h3>g_str_has_suffix ()</h3>
535
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_str_has_suffix (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
536
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *suffix</code></em>);</pre>
537
- <p>
538
- Looks whether the string <em class="parameter"><code>str</code></em> ends with <em class="parameter"><code>suffix</code></em>.
539
- </p>
540
- <div class="variablelist"><table border="0">
541
- <col align="left" valign="top">
542
- <tbody>
543
- <tr>
544
- <td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
545
- <td>a nul-terminated string.
546
- </td>
547
- </tr>
548
- <tr>
549
- <td><p><span class="term"><em class="parameter"><code>suffix</code></em> :</span></p></td>
550
- <td>the nul-terminated suffix to look for.
551
- </td>
552
- </tr>
553
- <tr>
554
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
555
- <td> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if <em class="parameter"><code>str</code></em> end with <em class="parameter"><code>suffix</code></em>, <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> otherwise.
556
-
557
- </td>
558
- </tr>
559
- </tbody>
560
- </table></div>
561
- <p class="since">Since 2.2</p>
562
- </div>
563
- <hr>
564
- <div class="refsect2">
565
- <a name="g-strcmp0"></a><h3>g_strcmp0 ()</h3>
566
- <pre class="programlisting"><span class="returnvalue">int</span> g_strcmp0 (<em class="parameter"><code>const <span class="type">char</span> *str1</code></em>,
567
- <em class="parameter"><code>const <span class="type">char</span> *str2</code></em>);</pre>
568
- <p>
569
- Compares <em class="parameter"><code>str1</code></em> and <em class="parameter"><code>str2</code></em> like <code class="function">strcmp()</code>. Handles <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
570
- gracefully by sorting it before non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> strings.
571
- Comparing two <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> pointers returns 0.
572
- </p>
573
- <div class="variablelist"><table border="0">
574
- <col align="left" valign="top">
575
- <tbody>
576
- <tr>
577
- <td><p><span class="term"><em class="parameter"><code>str1</code></em> :</span></p></td>
578
- <td>a C string or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
579
- </td>
580
- </tr>
581
- <tr>
582
- <td><p><span class="term"><em class="parameter"><code>str2</code></em> :</span></p></td>
583
- <td>another C string or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></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> -1, 0 or 1, if <em class="parameter"><code>str1</code></em> is &lt;, == or &gt; than <em class="parameter"><code>str2</code></em>.
589
-
590
- </td>
591
- </tr>
592
- </tbody>
593
- </table></div>
594
- <p class="since">Since 2.16</p>
595
- </div>
596
- <hr>
597
- <div class="refsect2">
598
- <a name="g-strlcpy"></a><h3>g_strlcpy ()</h3>
599
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="returnvalue">gsize</span></a> g_strlcpy (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *dest</code></em>,
600
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *src</code></em>,
601
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> dest_size</code></em>);</pre>
602
- <p>
603
- Portability wrapper that calls <code class="function">strlcpy()</code> on systems which have it,
604
- and emulates <code class="function">strlcpy()</code> otherwise. Copies <em class="parameter"><code>src</code></em> to <em class="parameter"><code>dest</code></em>; <em class="parameter"><code>dest</code></em> is
605
- guaranteed to be nul-terminated; <em class="parameter"><code>src</code></em> must be nul-terminated;
606
- <em class="parameter"><code>dest_size</code></em> is the buffer size, not the number of chars to copy.
607
- </p>
608
- <p>
609
- At most dest_size - 1 characters will be copied. Always nul-terminates
610
- (unless dest_size == 0). This function does <span class="emphasis"><em>not</em></span>
611
- allocate memory. Unlike <code class="function">strncpy()</code>, this function doesn't pad dest (so
612
- it's often faster). It returns the size of the attempted result,
613
- strlen (src), so if <em class="parameter"><code>retval</code></em> &gt;= <em class="parameter"><code>dest_size</code></em>, truncation occurred.
614
- </p>
615
- <p>
616
- </p>
617
- <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
618
- <h3 class="title">Note</h3>
619
- <p>Caveat: <code class="function">strlcpy()</code> is supposedly more secure than
620
- <code class="function">strcpy()</code> or <code class="function">strncpy()</code>, but if you really want to avoid screwups,
621
- <a class="link" href="glib-String-Utility-Functions.html#g-strdup" title="g_strdup ()"><code class="function">g_strdup()</code></a> is an even better idea.</p>
622
- </div>
623
- <p>
624
- </p>
625
- <div class="variablelist"><table border="0">
626
- <col align="left" valign="top">
627
- <tbody>
628
- <tr>
629
- <td><p><span class="term"><em class="parameter"><code>dest</code></em> :</span></p></td>
630
- <td>destination buffer
631
- </td>
632
- </tr>
633
- <tr>
634
- <td><p><span class="term"><em class="parameter"><code>src</code></em> :</span></p></td>
635
- <td>source buffer
636
- </td>
637
- </tr>
638
- <tr>
639
- <td><p><span class="term"><em class="parameter"><code>dest_size</code></em> :</span></p></td>
640
- <td>length of <em class="parameter"><code>dest</code></em> in bytes
641
- </td>
642
- </tr>
643
- <tr>
644
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
645
- <td> length of <em class="parameter"><code>src</code></em>
646
- </td>
647
- </tr>
648
- </tbody>
649
- </table></div>
650
- </div>
651
- <hr>
652
- <div class="refsect2">
653
- <a name="g-strlcat"></a><h3>g_strlcat ()</h3>
654
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="returnvalue">gsize</span></a> g_strlcat (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *dest</code></em>,
655
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *src</code></em>,
656
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> dest_size</code></em>);</pre>
657
- <p>
658
- Portability wrapper that calls <code class="function">strlcat()</code> on systems which have it,
659
- and emulates it otherwise. Appends nul-terminated <em class="parameter"><code>src</code></em> string to <em class="parameter"><code>dest</code></em>,
660
- guaranteeing nul-termination for <em class="parameter"><code>dest</code></em>. The total size of <em class="parameter"><code>dest</code></em> won't
661
- exceed <em class="parameter"><code>dest_size</code></em>.
662
- </p>
663
- <p>
664
- At most dest_size - 1 characters will be copied.
665
- Unlike strncat, dest_size is the full size of dest, not the space left over.
666
- This function does NOT allocate memory.
667
- This always NUL terminates (unless siz == 0 or there were no NUL characters
668
- in the dest_size characters of dest to start with).
669
- </p>
670
- <p>
671
- </p>
672
- <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
673
- <h3 class="title">Note</h3>
674
- <p>Caveat: this is supposedly a more secure alternative to
675
- <code class="function">strcat()</code> or <code class="function">strncat()</code>, but for real security <a class="link" href="glib-String-Utility-Functions.html#g-strconcat" title="g_strconcat ()"><code class="function">g_strconcat()</code></a> is harder
676
- to mess up.</p>
677
- </div>
678
- <p>
679
- </p>
680
- <div class="variablelist"><table border="0">
681
- <col align="left" valign="top">
682
- <tbody>
683
- <tr>
684
- <td><p><span class="term"><em class="parameter"><code>dest</code></em> :</span></p></td>
685
- <td>destination buffer, already containing one nul-terminated string
686
- </td>
687
- </tr>
688
- <tr>
689
- <td><p><span class="term"><em class="parameter"><code>src</code></em> :</span></p></td>
690
- <td>source buffer
691
- </td>
692
- </tr>
693
- <tr>
694
- <td><p><span class="term"><em class="parameter"><code>dest_size</code></em> :</span></p></td>
695
- <td>length of <em class="parameter"><code>dest</code></em> buffer in bytes (not length of existing string
696
- inside <em class="parameter"><code>dest</code></em>)
697
- </td>
698
- </tr>
699
- <tr>
700
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
701
- <td> size of attempted result, which is MIN (dest_size, strlen
702
- (original dest)) + strlen (src), so if retval &gt;= dest_size,
703
- truncation occurred.
704
- </td>
705
- </tr>
706
- </tbody>
707
- </table></div>
708
- </div>
709
- <hr>
710
- <div class="refsect2">
711
- <a name="g-strdup-printf"></a><h3>g_strdup_printf ()</h3>
712
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_strdup_printf (<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>,
713
- <em class="parameter"><code>...</code></em>);</pre>
714
- <p>
715
- Similar to the standard C <code class="function">sprintf()</code> function but safer, since it
716
- calculates the maximum space required and allocates memory to hold
717
- the result. The returned string should be freed with <a class="link" href="glib-Memory-Allocation.html#g-free" title="g_free ()"><code class="function">g_free()</code></a> when no
718
- longer needed.
719
- </p>
720
- <div class="variablelist"><table border="0">
721
- <col align="left" valign="top">
722
- <tbody>
723
- <tr>
724
- <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
725
- <td>a standard <code class="function">printf()</code> format string, but notice
726
- <a class="link" href="glib-String-Utility-Functions.html#string-precision">string precision pitfalls</a>
727
- </td>
728
- </tr>
729
- <tr>
730
- <td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
731
- <td>the parameters to insert into the format string
732
- </td>
733
- </tr>
734
- <tr>
735
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
736
- <td> a newly-allocated string holding the result
737
- </td>
738
- </tr>
739
- </tbody>
740
- </table></div>
741
- </div>
742
- <hr>
743
- <div class="refsect2">
744
- <a name="g-strdup-vprintf"></a><h3>g_strdup_vprintf ()</h3>
745
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_strdup_vprintf (<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>,
746
- <em class="parameter"><code><span class="type">va_list</span> args</code></em>);</pre>
747
- <p>
748
- Similar to the standard C <code class="function">vsprintf()</code> function but safer, since it
749
- calculates the maximum space required and allocates memory to hold
750
- the result. The returned string should be freed with <a class="link" href="glib-Memory-Allocation.html#g-free" title="g_free ()"><code class="function">g_free()</code></a> when
751
- no longer needed.
752
- </p>
753
- <p>
754
- See also <a class="link" href="glib-String-Utility-Functions.html#g-vasprintf" title="g_vasprintf ()"><code class="function">g_vasprintf()</code></a>, which offers the same functionality, but
755
- additionally returns the length of the allocated string.
756
- </p>
757
- <div class="variablelist"><table border="0">
758
- <col align="left" valign="top">
759
- <tbody>
760
- <tr>
761
- <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
762
- <td>a standard <code class="function">printf()</code> format string, but notice
763
- <a class="link" href="glib-String-Utility-Functions.html#string-precision">string precision pitfalls</a>
764
- </td>
765
- </tr>
766
- <tr>
767
- <td><p><span class="term"><em class="parameter"><code>args</code></em> :</span></p></td>
768
- <td>the list of parameters to insert into the format string
769
- </td>
770
- </tr>
771
- <tr>
772
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
773
- <td> a newly-allocated string holding the result
774
- </td>
775
- </tr>
776
- </tbody>
777
- </table></div>
778
- </div>
779
- <hr>
780
- <div class="refsect2">
781
- <a name="g-printf"></a><h3>g_printf ()</h3>
782
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> g_printf (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> const *format</code></em>,
783
- <em class="parameter"><code>...</code></em>);</pre>
784
- <p>
785
- An implementation of the standard <code class="function">printf()</code> function which supports
786
- positional parameters, as specified in the Single Unix Specification.
787
- </p>
788
- <div class="variablelist"><table border="0">
789
- <col align="left" valign="top">
790
- <tbody>
791
- <tr>
792
- <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
793
- <td>a standard <code class="function">printf()</code> format string, but notice
794
- <a class="link" href="glib-String-Utility-Functions.html#string-precision">string precision pitfalls</a>.
795
- </td>
796
- </tr>
797
- <tr>
798
- <td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
799
- <td>the arguments to insert in the output.
800
- </td>
801
- </tr>
802
- <tr>
803
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
804
- <td> the number of bytes printed.
805
-
806
- </td>
807
- </tr>
808
- </tbody>
809
- </table></div>
810
- <p class="since">Since 2.2</p>
811
- </div>
812
- <hr>
813
- <div class="refsect2">
814
- <a name="g-vprintf"></a><h3>g_vprintf ()</h3>
815
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> g_vprintf (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> const *format</code></em>,
816
- <em class="parameter"><code><span class="type">va_list</span> args</code></em>);</pre>
817
- <p>
818
- An implementation of the standard <code class="function">vprintf()</code> function which supports
819
- positional parameters, as specified in the Single Unix Specification.
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>format</code></em> :</span></p></td>
826
- <td>a standard <code class="function">printf()</code> format string, but notice
827
- <a class="link" href="glib-String-Utility-Functions.html#string-precision">string precision pitfalls</a>.
828
- </td>
829
- </tr>
830
- <tr>
831
- <td><p><span class="term"><em class="parameter"><code>args</code></em> :</span></p></td>
832
- <td>the list of arguments to insert in the output.
833
- </td>
834
- </tr>
835
- <tr>
836
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
837
- <td> the number of bytes printed.
838
-
839
- </td>
840
- </tr>
841
- </tbody>
842
- </table></div>
843
- <p class="since">Since 2.2</p>
844
- </div>
845
- <hr>
846
- <div class="refsect2">
847
- <a name="g-fprintf"></a><h3>g_fprintf ()</h3>
848
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> g_fprintf (<em class="parameter"><code><span class="type">FILE</span> *file</code></em>,
849
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> const *format</code></em>,
850
- <em class="parameter"><code>...</code></em>);</pre>
851
- <p>
852
- An implementation of the standard <code class="function">fprintf()</code> function which supports
853
- positional parameters, as specified in the Single Unix Specification.
854
- </p>
855
- <div class="variablelist"><table border="0">
856
- <col align="left" valign="top">
857
- <tbody>
858
- <tr>
859
- <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
860
- <td>the stream to write to.
861
- </td>
862
- </tr>
863
- <tr>
864
- <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
865
- <td>a standard <code class="function">printf()</code> format string, but notice
866
- <a class="link" href="glib-String-Utility-Functions.html#string-precision">string precision pitfalls</a>.
867
- </td>
868
- </tr>
869
- <tr>
870
- <td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
871
- <td>the arguments to insert in the output.
872
- </td>
873
- </tr>
874
- <tr>
875
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
876
- <td> the number of bytes printed.
877
-
878
- </td>
879
- </tr>
880
- </tbody>
881
- </table></div>
882
- <p class="since">Since 2.2</p>
883
- </div>
884
- <hr>
885
- <div class="refsect2">
886
- <a name="g-vfprintf"></a><h3>g_vfprintf ()</h3>
887
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> g_vfprintf (<em class="parameter"><code><span class="type">FILE</span> *file</code></em>,
888
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> const *format</code></em>,
889
- <em class="parameter"><code><span class="type">va_list</span> args</code></em>);</pre>
890
- <p>
891
- An implementation of the standard <code class="function">fprintf()</code> function which supports
892
- positional parameters, as specified in the Single Unix Specification.
893
- </p>
894
- <div class="variablelist"><table border="0">
895
- <col align="left" valign="top">
896
- <tbody>
897
- <tr>
898
- <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
899
- <td>the stream to write to.
900
- </td>
901
- </tr>
902
- <tr>
903
- <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
904
- <td>a standard <code class="function">printf()</code> format string, but notice
905
- <a class="link" href="glib-String-Utility-Functions.html#string-precision">string precision pitfalls</a>.
906
- </td>
907
- </tr>
908
- <tr>
909
- <td><p><span class="term"><em class="parameter"><code>args</code></em> :</span></p></td>
910
- <td>the list of arguments to insert in the output.
911
- </td>
912
- </tr>
913
- <tr>
914
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
915
- <td> the number of bytes printed.
916
-
917
- </td>
918
- </tr>
919
- </tbody>
920
- </table></div>
921
- <p class="since">Since 2.2</p>
922
- </div>
923
- <hr>
924
- <div class="refsect2">
925
- <a name="g-sprintf"></a><h3>g_sprintf ()</h3>
926
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> g_sprintf (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *string</code></em>,
927
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> const *format</code></em>,
928
- <em class="parameter"><code>...</code></em>);</pre>
929
- <p>
930
- An implementation of the standard <code class="function">sprintf()</code> function which supports
931
- positional parameters, as specified in the Single Unix Specification.
932
- </p>
933
- <p>
934
- Note that it is usually better to use <a class="link" href="glib-String-Utility-Functions.html#g-snprintf" title="g_snprintf ()"><code class="function">g_snprintf()</code></a>, to avoid the
935
- risk of buffer overflow.
936
- </p>
937
- <p>
938
- See also <a class="link" href="glib-String-Utility-Functions.html#g-strdup-printf" title="g_strdup_printf ()"><code class="function">g_strdup_printf()</code></a>.
939
- </p>
940
- <div class="variablelist"><table border="0">
941
- <col align="left" valign="top">
942
- <tbody>
943
- <tr>
944
- <td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
945
- <td>A pointer to a memory buffer to contain the resulting string. It
946
- is up to the caller to ensure that the allocated buffer is large
947
- enough to hold the formatted result
948
- </td>
949
- </tr>
950
- <tr>
951
- <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
952
- <td>a standard <code class="function">printf()</code> format string, but notice
953
- <a class="link" href="glib-String-Utility-Functions.html#string-precision">string precision pitfalls</a>.
954
- </td>
955
- </tr>
956
- <tr>
957
- <td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
958
- <td>the arguments to insert in the output.
959
- </td>
960
- </tr>
961
- <tr>
962
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
963
- <td> the number of bytes printed.
964
-
965
- </td>
966
- </tr>
967
- </tbody>
968
- </table></div>
969
- <p class="since">Since 2.2</p>
970
- </div>
971
- <hr>
972
- <div class="refsect2">
973
- <a name="g-vsprintf"></a><h3>g_vsprintf ()</h3>
974
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> g_vsprintf (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *string</code></em>,
975
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> const *format</code></em>,
976
- <em class="parameter"><code><span class="type">va_list</span> args</code></em>);</pre>
977
- <p>
978
- An implementation of the standard <code class="function">vsprintf()</code> function which supports
979
- positional parameters, as specified in the Single Unix Specification.
980
- </p>
981
- <div class="variablelist"><table border="0">
982
- <col align="left" valign="top">
983
- <tbody>
984
- <tr>
985
- <td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
986
- <td>the buffer to hold the output.
987
- </td>
988
- </tr>
989
- <tr>
990
- <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
991
- <td>a standard <code class="function">printf()</code> format string, but notice
992
- <a class="link" href="glib-String-Utility-Functions.html#string-precision">string precision pitfalls</a>.
993
- </td>
994
- </tr>
995
- <tr>
996
- <td><p><span class="term"><em class="parameter"><code>args</code></em> :</span></p></td>
997
- <td>the list of arguments to insert in the output.
998
- </td>
999
- </tr>
1000
- <tr>
1001
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1002
- <td> the number of bytes printed.
1003
-
1004
- </td>
1005
- </tr>
1006
- </tbody>
1007
- </table></div>
1008
- <p class="since">Since 2.2</p>
1009
- </div>
1010
- <hr>
1011
- <div class="refsect2">
1012
- <a name="g-snprintf"></a><h3>g_snprintf ()</h3>
1013
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> g_snprintf (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *string</code></em>,
1014
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gulong" title="gulong"><span class="type">gulong</span></a> n</code></em>,
1015
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> const *format</code></em>,
1016
- <em class="parameter"><code>...</code></em>);</pre>
1017
- <p>
1018
- A safer form of the standard <code class="function">sprintf()</code> function. The output is guaranteed
1019
- to not exceed <em class="parameter"><code>n</code></em> characters (including the terminating nul character), so
1020
- it is easy to ensure that a buffer overflow cannot occur.
1021
- </p>
1022
- <p>
1023
- See also <a class="link" href="glib-String-Utility-Functions.html#g-strdup-printf" title="g_strdup_printf ()"><code class="function">g_strdup_printf()</code></a>.
1024
- </p>
1025
- <p>
1026
- In versions of GLib prior to 1.2.3, this function may return -1 if the
1027
- output was truncated, and the truncated string may not be nul-terminated.
1028
- In versions prior to 1.3.12, this function returns the length of the output
1029
- string.
1030
- </p>
1031
- <p>
1032
- The return value of <a class="link" href="glib-String-Utility-Functions.html#g-snprintf" title="g_snprintf ()"><code class="function">g_snprintf()</code></a> conforms to the <code class="function">snprintf()</code>
1033
- function as standardized in ISO C99. Note that this is different from
1034
- traditional <code class="function">snprintf()</code>, which returns the length of the output string.
1035
- </p>
1036
- <p>
1037
- The format string may contain positional parameters, as specified in
1038
- the Single Unix Specification.
1039
- </p>
1040
- <div class="variablelist"><table border="0">
1041
- <col align="left" valign="top">
1042
- <tbody>
1043
- <tr>
1044
- <td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
1045
- <td>the buffer to hold the output.
1046
- </td>
1047
- </tr>
1048
- <tr>
1049
- <td><p><span class="term"><em class="parameter"><code>n</code></em> :</span></p></td>
1050
- <td>the maximum number of bytes to produce (including the
1051
- terminating nul character).
1052
- </td>
1053
- </tr>
1054
- <tr>
1055
- <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
1056
- <td>a standard <code class="function">printf()</code> format string, but notice
1057
- <a class="link" href="glib-String-Utility-Functions.html#string-precision">string precision pitfalls</a>.
1058
- </td>
1059
- </tr>
1060
- <tr>
1061
- <td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
1062
- <td>the arguments to insert in the output.
1063
- </td>
1064
- </tr>
1065
- <tr>
1066
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1067
- <td> the number of bytes which would be produced if the buffer
1068
- was large enough.
1069
- </td>
1070
- </tr>
1071
- </tbody>
1072
- </table></div>
1073
- </div>
1074
- <hr>
1075
- <div class="refsect2">
1076
- <a name="g-vsnprintf"></a><h3>g_vsnprintf ()</h3>
1077
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> g_vsnprintf (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *string</code></em>,
1078
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gulong" title="gulong"><span class="type">gulong</span></a> n</code></em>,
1079
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> const *format</code></em>,
1080
- <em class="parameter"><code><span class="type">va_list</span> args</code></em>);</pre>
1081
- <p>
1082
- A safer form of the standard <code class="function">vsprintf()</code> function. The output is guaranteed
1083
- to not exceed <em class="parameter"><code>n</code></em> characters (including the terminating nul character), so
1084
- it is easy to ensure that a buffer overflow cannot occur.
1085
- </p>
1086
- <p>
1087
- See also <a class="link" href="glib-String-Utility-Functions.html#g-strdup-vprintf" title="g_strdup_vprintf ()"><code class="function">g_strdup_vprintf()</code></a>.
1088
- </p>
1089
- <p>
1090
- In versions of GLib prior to 1.2.3, this function may return -1 if the
1091
- output was truncated, and the truncated string may not be nul-terminated.
1092
- In versions prior to 1.3.12, this function returns the length of the output
1093
- string.
1094
- </p>
1095
- <p>
1096
- The return value of <a class="link" href="glib-String-Utility-Functions.html#g-vsnprintf" title="g_vsnprintf ()"><code class="function">g_vsnprintf()</code></a> conforms to the <code class="function">vsnprintf()</code> function
1097
- as standardized in ISO C99. Note that this is different from traditional
1098
- <code class="function">vsnprintf()</code>, which returns the length of the output string.
1099
- </p>
1100
- <p>
1101
- The format string may contain positional parameters, as specified in
1102
- the Single Unix Specification.
1103
- </p>
1104
- <div class="variablelist"><table border="0">
1105
- <col align="left" valign="top">
1106
- <tbody>
1107
- <tr>
1108
- <td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
1109
- <td>the buffer to hold the output.
1110
- </td>
1111
- </tr>
1112
- <tr>
1113
- <td><p><span class="term"><em class="parameter"><code>n</code></em> :</span></p></td>
1114
- <td>the maximum number of bytes to produce (including the
1115
- terminating nul character).
1116
- </td>
1117
- </tr>
1118
- <tr>
1119
- <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
1120
- <td>a standard <code class="function">printf()</code> format string, but notice
1121
- <a class="link" href="glib-String-Utility-Functions.html#string-precision">string precision pitfalls</a>.
1122
- </td>
1123
- </tr>
1124
- <tr>
1125
- <td><p><span class="term"><em class="parameter"><code>args</code></em> :</span></p></td>
1126
- <td>the list of arguments to insert in the output.
1127
- </td>
1128
- </tr>
1129
- <tr>
1130
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1131
- <td> the number of bytes which would be produced if the buffer
1132
- was large enough.
1133
- </td>
1134
- </tr>
1135
- </tbody>
1136
- </table></div>
1137
- </div>
1138
- <hr>
1139
- <div class="refsect2">
1140
- <a name="g-vasprintf"></a><h3>g_vasprintf ()</h3>
1141
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> g_vasprintf (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **string</code></em>,
1142
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> const *format</code></em>,
1143
- <em class="parameter"><code><span class="type">va_list</span> args</code></em>);</pre>
1144
- <p>
1145
- An implementation of the GNU <code class="function">vasprintf()</code> function which supports
1146
- positional parameters, as specified in the Single Unix Specification.
1147
- This function is similar to <a class="link" href="glib-String-Utility-Functions.html#g-vsprintf" title="g_vsprintf ()"><code class="function">g_vsprintf()</code></a>, except that it allocates a
1148
- string to hold the output, instead of putting the output in a buffer
1149
- you allocate in advance.
1150
- </p>
1151
- <div class="variablelist"><table border="0">
1152
- <col align="left" valign="top">
1153
- <tbody>
1154
- <tr>
1155
- <td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
1156
- <td>the return location for the newly-allocated string.
1157
- </td>
1158
- </tr>
1159
- <tr>
1160
- <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
1161
- <td>a standard <code class="function">printf()</code> format string, but notice
1162
- <a class="link" href="glib-String-Utility-Functions.html#string-precision">string precision pitfalls</a>.
1163
- </td>
1164
- </tr>
1165
- <tr>
1166
- <td><p><span class="term"><em class="parameter"><code>args</code></em> :</span></p></td>
1167
- <td>the list of arguments to insert in the output.
1168
- </td>
1169
- </tr>
1170
- <tr>
1171
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1172
- <td> the number of bytes printed.
1173
-
1174
- </td>
1175
- </tr>
1176
- </tbody>
1177
- </table></div>
1178
- <p class="since">Since 2.4</p>
1179
- </div>
1180
- <hr>
1181
- <div class="refsect2">
1182
- <a name="g-printf-string-upper-bound"></a><h3>g_printf_string_upper_bound ()</h3>
1183
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="returnvalue">gsize</span></a> g_printf_string_upper_bound (<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>,
1184
- <em class="parameter"><code><span class="type">va_list</span> args</code></em>);</pre>
1185
- <p>
1186
- Calculates the maximum space needed to store the output of the <code class="function">sprintf()</code>
1187
- function.
1188
- </p>
1189
- <div class="variablelist"><table border="0">
1190
- <col align="left" valign="top">
1191
- <tbody>
1192
- <tr>
1193
- <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
1194
- <td>the format string. See the <code class="function">printf()</code> documentation.
1195
- </td>
1196
- </tr>
1197
- <tr>
1198
- <td><p><span class="term"><em class="parameter"><code>args</code></em> :</span></p></td>
1199
- <td>the parameters to be inserted into the format string.
1200
- </td>
1201
- </tr>
1202
- <tr>
1203
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1204
- <td>the maximum space needed to store the formatted string.
1205
- </td>
1206
- </tr>
1207
- </tbody>
1208
- </table></div>
1209
- </div>
1210
- <hr>
1211
- <div class="refsect2">
1212
- <a name="g-ascii-isalnum"></a><h3>g_ascii_isalnum ()</h3>
1213
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_ascii_isalnum (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> c</code></em>);</pre>
1214
- <p>
1215
- Determines whether a character is alphanumeric.
1216
- </p>
1217
- <p>
1218
- Unlike the standard C library <code class="function">isalnum()</code> function, this only
1219
- recognizes standard ASCII letters and ignores the locale, returning
1220
- <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> for all non-ASCII characters. Also unlike the standard
1221
- library function, this takes a <span class="type">char</span>, not an <span class="type">int</span>,
1222
- so don't call it on <code class="literal">EOF</code> but no need to cast to <a class="link" href="glib-Basic-Types.html#guchar" title="guchar"><span class="type">guchar</span></a> before passing a
1223
- possibly non-ASCII character in.
1224
- </p>
1225
- <div class="variablelist"><table border="0">
1226
- <col align="left" valign="top">
1227
- <tbody>
1228
- <tr>
1229
- <td><p><span class="term"><em class="parameter"><code>c</code></em> :</span></p></td>
1230
- <td>any character
1231
- </td>
1232
- </tr>
1233
- <tr>
1234
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1235
- <td>
1236
- <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if <em class="parameter"><code>c</code></em> is an ASCII alphanumeric character
1237
- </td>
1238
- </tr>
1239
- </tbody>
1240
- </table></div>
1241
- </div>
1242
- <hr>
1243
- <div class="refsect2">
1244
- <a name="g-ascii-isalpha"></a><h3>g_ascii_isalpha ()</h3>
1245
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_ascii_isalpha (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> c</code></em>);</pre>
1246
- <p>
1247
- Determines whether a character is alphabetic (i.e. a letter).
1248
- </p>
1249
- <p>
1250
- Unlike the standard C library <code class="function">isalpha()</code> function, this only
1251
- recognizes standard ASCII letters and ignores the locale, returning
1252
- <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> for all non-ASCII characters. Also unlike the standard
1253
- library function, this takes a <span class="type">char</span>, not an <span class="type">int</span>,
1254
- so don't call it on <code class="literal">EOF</code> but no need to cast to <a class="link" href="glib-Basic-Types.html#guchar" title="guchar"><span class="type">guchar</span></a> before passing a
1255
- possibly non-ASCII character in.
1256
- </p>
1257
- <div class="variablelist"><table border="0">
1258
- <col align="left" valign="top">
1259
- <tbody>
1260
- <tr>
1261
- <td><p><span class="term"><em class="parameter"><code>c</code></em> :</span></p></td>
1262
- <td>any character
1263
- </td>
1264
- </tr>
1265
- <tr>
1266
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1267
- <td>
1268
- <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if <em class="parameter"><code>c</code></em> is an ASCII alphabetic character
1269
- </td>
1270
- </tr>
1271
- </tbody>
1272
- </table></div>
1273
- </div>
1274
- <hr>
1275
- <div class="refsect2">
1276
- <a name="g-ascii-iscntrl"></a><h3>g_ascii_iscntrl ()</h3>
1277
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_ascii_iscntrl (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> c</code></em>);</pre>
1278
- <p>
1279
- Determines whether a character is a control character.
1280
- </p>
1281
- <p>
1282
- Unlike the standard C library <code class="function">iscntrl()</code> function, this only
1283
- recognizes standard ASCII control characters and ignores the locale,
1284
- returning <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> for all non-ASCII characters. Also unlike the standard
1285
- library function, this takes a <span class="type">char</span>, not an <span class="type">int</span>,
1286
- so don't call it on <code class="literal">EOF</code> but no need to cast to <a class="link" href="glib-Basic-Types.html#guchar" title="guchar"><span class="type">guchar</span></a> before passing a
1287
- possibly non-ASCII character in.
1288
- </p>
1289
- <div class="variablelist"><table border="0">
1290
- <col align="left" valign="top">
1291
- <tbody>
1292
- <tr>
1293
- <td><p><span class="term"><em class="parameter"><code>c</code></em> :</span></p></td>
1294
- <td>any character
1295
- </td>
1296
- </tr>
1297
- <tr>
1298
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1299
- <td>
1300
- <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if <em class="parameter"><code>c</code></em> is an ASCII control character.
1301
- </td>
1302
- </tr>
1303
- </tbody>
1304
- </table></div>
1305
- </div>
1306
- <hr>
1307
- <div class="refsect2">
1308
- <a name="g-ascii-isdigit"></a><h3>g_ascii_isdigit ()</h3>
1309
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_ascii_isdigit (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> c</code></em>);</pre>
1310
- <p>
1311
- Determines whether a character is digit (0-9).
1312
- </p>
1313
- <p>
1314
- Unlike the standard C library <code class="function">isdigit()</code> function,
1315
- this takes a <span class="type">char</span>, not an <span class="type">int</span>, so don't call it
1316
- on <code class="literal">EOF</code> but no need to cast to <a class="link" href="glib-Basic-Types.html#guchar" title="guchar"><span class="type">guchar</span></a> before passing a possibly
1317
- non-ASCII character in.
1318
- </p>
1319
- <div class="variablelist"><table border="0">
1320
- <col align="left" valign="top">
1321
- <tbody>
1322
- <tr>
1323
- <td><p><span class="term"><em class="parameter"><code>c</code></em> :</span></p></td>
1324
- <td>any character
1325
- </td>
1326
- </tr>
1327
- <tr>
1328
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1329
- <td>
1330
- <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if <em class="parameter"><code>c</code></em> is an ASCII digit.
1331
- </td>
1332
- </tr>
1333
- </tbody>
1334
- </table></div>
1335
- </div>
1336
- <hr>
1337
- <div class="refsect2">
1338
- <a name="g-ascii-isgraph"></a><h3>g_ascii_isgraph ()</h3>
1339
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_ascii_isgraph (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> c</code></em>);</pre>
1340
- <p>
1341
- Determines whether a character is a printing character and not a space.
1342
- </p>
1343
- <p>
1344
- Unlike the standard C library <code class="function">isgraph()</code> function,
1345
- this only recognizes standard ASCII characters and ignores the locale,
1346
- returning <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> for all non-ASCII characters. Also unlike the standard
1347
- library function, this takes a <span class="type">char</span>, not an <span class="type">int</span>,
1348
- so don't call it on <code class="literal">EOF</code> but no need to cast to <a class="link" href="glib-Basic-Types.html#guchar" title="guchar"><span class="type">guchar</span></a> before passing a
1349
- possibly non-ASCII character in.
1350
- </p>
1351
- <div class="variablelist"><table border="0">
1352
- <col align="left" valign="top">
1353
- <tbody>
1354
- <tr>
1355
- <td><p><span class="term"><em class="parameter"><code>c</code></em> :</span></p></td>
1356
- <td>any character
1357
- </td>
1358
- </tr>
1359
- <tr>
1360
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1361
- <td>
1362
- <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if <em class="parameter"><code>c</code></em> is an ASCII printing character other than space.
1363
- </td>
1364
- </tr>
1365
- </tbody>
1366
- </table></div>
1367
- </div>
1368
- <hr>
1369
- <div class="refsect2">
1370
- <a name="g-ascii-islower"></a><h3>g_ascii_islower ()</h3>
1371
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_ascii_islower (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> c</code></em>);</pre>
1372
- <p>
1373
- Determines whether a character is an ASCII lower case letter.
1374
- </p>
1375
- <p>
1376
- Unlike the standard C library <code class="function">islower()</code> function,
1377
- this only recognizes standard ASCII letters and ignores the locale,
1378
- returning <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> for all non-ASCII characters. Also unlike the standard
1379
- library function, this takes a <span class="type">char</span>, not an <span class="type">int</span>,
1380
- so don't call it on <code class="literal">EOF</code> but no need to worry about casting to <a class="link" href="glib-Basic-Types.html#guchar" title="guchar"><span class="type">guchar</span></a>
1381
- before passing a possibly non-ASCII character in.
1382
- </p>
1383
- <div class="variablelist"><table border="0">
1384
- <col align="left" valign="top">
1385
- <tbody>
1386
- <tr>
1387
- <td><p><span class="term"><em class="parameter"><code>c</code></em> :</span></p></td>
1388
- <td>any character
1389
- </td>
1390
- </tr>
1391
- <tr>
1392
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1393
- <td>
1394
- <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if <em class="parameter"><code>c</code></em> is an ASCII lower case letter
1395
- </td>
1396
- </tr>
1397
- </tbody>
1398
- </table></div>
1399
- </div>
1400
- <hr>
1401
- <div class="refsect2">
1402
- <a name="g-ascii-isprint"></a><h3>g_ascii_isprint ()</h3>
1403
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_ascii_isprint (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> c</code></em>);</pre>
1404
- <p>
1405
- Determines whether a character is a printing character.
1406
- </p>
1407
- <p>
1408
- Unlike the standard C library <code class="function">isprint()</code> function,
1409
- this only recognizes standard ASCII characters and ignores the locale,
1410
- returning <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> for all non-ASCII characters. Also unlike the standard
1411
- library function, this takes a <span class="type">char</span>, not an <span class="type">int</span>,
1412
- so don't call it on <code class="literal">EOF</code> but no need to cast to <a class="link" href="glib-Basic-Types.html#guchar" title="guchar"><span class="type">guchar</span></a> before passing a
1413
- possibly non-ASCII character in.
1414
- </p>
1415
- <div class="variablelist"><table border="0">
1416
- <col align="left" valign="top">
1417
- <tbody>
1418
- <tr>
1419
- <td><p><span class="term"><em class="parameter"><code>c</code></em> :</span></p></td>
1420
- <td>any character
1421
- </td>
1422
- </tr>
1423
- <tr>
1424
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1425
- <td>
1426
- <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if <em class="parameter"><code>c</code></em> is an ASCII printing character.
1427
- </td>
1428
- </tr>
1429
- </tbody>
1430
- </table></div>
1431
- </div>
1432
- <hr>
1433
- <div class="refsect2">
1434
- <a name="g-ascii-ispunct"></a><h3>g_ascii_ispunct ()</h3>
1435
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_ascii_ispunct (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> c</code></em>);</pre>
1436
- <p>
1437
- Determines whether a character is a punctuation character.
1438
- </p>
1439
- <p>
1440
- Unlike the standard C library <code class="function">ispunct()</code> function,
1441
- this only recognizes standard ASCII letters and ignores the locale,
1442
- returning <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> for all non-ASCII characters. Also unlike the standard
1443
- library function, this takes a <span class="type">char</span>, not an <span class="type">int</span>,
1444
- so don't call it on <code class="literal">EOF</code> but no need to cast to <a class="link" href="glib-Basic-Types.html#guchar" title="guchar"><span class="type">guchar</span></a> before passing a
1445
- possibly non-ASCII character in.
1446
- </p>
1447
- <div class="variablelist"><table border="0">
1448
- <col align="left" valign="top">
1449
- <tbody>
1450
- <tr>
1451
- <td><p><span class="term"><em class="parameter"><code>c</code></em> :</span></p></td>
1452
- <td>any character
1453
- </td>
1454
- </tr>
1455
- <tr>
1456
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1457
- <td>
1458
- <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if <em class="parameter"><code>c</code></em> is an ASCII punctuation character.
1459
- </td>
1460
- </tr>
1461
- </tbody>
1462
- </table></div>
1463
- </div>
1464
- <hr>
1465
- <div class="refsect2">
1466
- <a name="g-ascii-isspace"></a><h3>g_ascii_isspace ()</h3>
1467
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_ascii_isspace (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> c</code></em>);</pre>
1468
- <p>
1469
- Determines whether a character is a white-space character.
1470
- </p>
1471
- <p>
1472
- Unlike the standard C library <code class="function">isspace()</code> function,
1473
- this only recognizes standard ASCII white-space and ignores the locale,
1474
- returning <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> for all non-ASCII characters. Also unlike the standard
1475
- library function, this takes a <span class="type">char</span>, not an <span class="type">int</span>,
1476
- so don't call it on <code class="literal">EOF</code> but no need to cast to <a class="link" href="glib-Basic-Types.html#guchar" title="guchar"><span class="type">guchar</span></a> before passing a
1477
- possibly non-ASCII character in.
1478
- </p>
1479
- <div class="variablelist"><table border="0">
1480
- <col align="left" valign="top">
1481
- <tbody>
1482
- <tr>
1483
- <td><p><span class="term"><em class="parameter"><code>c</code></em> :</span></p></td>
1484
- <td>any character
1485
- </td>
1486
- </tr>
1487
- <tr>
1488
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1489
- <td>
1490
- <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if <em class="parameter"><code>c</code></em> is an ASCII white-space character
1491
- </td>
1492
- </tr>
1493
- </tbody>
1494
- </table></div>
1495
- </div>
1496
- <hr>
1497
- <div class="refsect2">
1498
- <a name="g-ascii-isupper"></a><h3>g_ascii_isupper ()</h3>
1499
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_ascii_isupper (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> c</code></em>);</pre>
1500
- <p>
1501
- Determines whether a character is an ASCII upper case letter.
1502
- </p>
1503
- <p>
1504
- Unlike the standard C library <code class="function">isupper()</code> function,
1505
- this only recognizes standard ASCII letters and ignores the locale,
1506
- returning <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> for all non-ASCII characters. Also unlike the standard
1507
- library function, this takes a <span class="type">char</span>, not an <span class="type">int</span>,
1508
- so don't call it on <code class="literal">EOF</code> but no need to worry about casting to <a class="link" href="glib-Basic-Types.html#guchar" title="guchar"><span class="type">guchar</span></a>
1509
- before passing a possibly non-ASCII character in.
1510
- </p>
1511
- <div class="variablelist"><table border="0">
1512
- <col align="left" valign="top">
1513
- <tbody>
1514
- <tr>
1515
- <td><p><span class="term"><em class="parameter"><code>c</code></em> :</span></p></td>
1516
- <td>any character
1517
- </td>
1518
- </tr>
1519
- <tr>
1520
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1521
- <td>
1522
- <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if <em class="parameter"><code>c</code></em> is an ASCII upper case letter
1523
- </td>
1524
- </tr>
1525
- </tbody>
1526
- </table></div>
1527
- </div>
1528
- <hr>
1529
- <div class="refsect2">
1530
- <a name="g-ascii-isxdigit"></a><h3>g_ascii_isxdigit ()</h3>
1531
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_ascii_isxdigit (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> c</code></em>);</pre>
1532
- <p>
1533
- Determines whether a character is a hexadecimal-digit character.
1534
- </p>
1535
- <p>
1536
- Unlike the standard C library <code class="function">isxdigit()</code> function,
1537
- this takes a <span class="type">char</span>, not an <span class="type">int</span>, so
1538
- don't call it on <code class="literal">EOF</code> but no need to cast to <a class="link" href="glib-Basic-Types.html#guchar" title="guchar"><span class="type">guchar</span></a> before passing a
1539
- possibly non-ASCII character in.
1540
- </p>
1541
- <div class="variablelist"><table border="0">
1542
- <col align="left" valign="top">
1543
- <tbody>
1544
- <tr>
1545
- <td><p><span class="term"><em class="parameter"><code>c</code></em> :</span></p></td>
1546
- <td>any character
1547
- </td>
1548
- </tr>
1549
- <tr>
1550
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1551
- <td>
1552
- <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if <em class="parameter"><code>c</code></em> is an ASCII hexadecimal-digit character.
1553
- </td>
1554
- </tr>
1555
- </tbody>
1556
- </table></div>
1557
- </div>
1558
- <hr>
1559
- <div class="refsect2">
1560
- <a name="g-ascii-digit-value"></a><h3>g_ascii_digit_value ()</h3>
1561
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> g_ascii_digit_value (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> c</code></em>);</pre>
1562
- <p>
1563
- Determines the numeric value of a character as a decimal
1564
- digit. Differs from <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-digit-value" title="g_unichar_digit_value ()"><code class="function">g_unichar_digit_value()</code></a> because it takes
1565
- a char, so there's no worry about sign extension if characters
1566
- are signed.
1567
- </p>
1568
- <div class="variablelist"><table border="0">
1569
- <col align="left" valign="top">
1570
- <tbody>
1571
- <tr>
1572
- <td><p><span class="term"><em class="parameter"><code>c</code></em> :</span></p></td>
1573
- <td>an ASCII character.
1574
- </td>
1575
- </tr>
1576
- <tr>
1577
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1578
- <td> If <em class="parameter"><code>c</code></em> is a decimal digit (according to
1579
- <a class="link" href="glib-String-Utility-Functions.html#g-ascii-isdigit" title="g_ascii_isdigit ()"><code class="function">g_ascii_isdigit()</code></a>), its numeric value. Otherwise, -1.
1580
- </td>
1581
- </tr>
1582
- </tbody>
1583
- </table></div>
1584
- </div>
1585
- <hr>
1586
- <div class="refsect2">
1587
- <a name="g-ascii-xdigit-value"></a><h3>g_ascii_xdigit_value ()</h3>
1588
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> g_ascii_xdigit_value (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> c</code></em>);</pre>
1589
- <p>
1590
- Determines the numeric value of a character as a hexidecimal
1591
- digit. Differs from <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-xdigit-value" title="g_unichar_xdigit_value ()"><code class="function">g_unichar_xdigit_value()</code></a> because it takes
1592
- a char, so there's no worry about sign extension if characters
1593
- are signed.
1594
- </p>
1595
- <div class="variablelist"><table border="0">
1596
- <col align="left" valign="top">
1597
- <tbody>
1598
- <tr>
1599
- <td><p><span class="term"><em class="parameter"><code>c</code></em> :</span></p></td>
1600
- <td>an ASCII character.
1601
- </td>
1602
- </tr>
1603
- <tr>
1604
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1605
- <td> If <em class="parameter"><code>c</code></em> is a hex digit (according to
1606
- <a class="link" href="glib-String-Utility-Functions.html#g-ascii-isxdigit" title="g_ascii_isxdigit ()"><code class="function">g_ascii_isxdigit()</code></a>), its numeric value. Otherwise, -1.
1607
- </td>
1608
- </tr>
1609
- </tbody>
1610
- </table></div>
1611
- </div>
1612
- <hr>
1613
- <div class="refsect2">
1614
- <a name="g-ascii-strcasecmp"></a><h3>g_ascii_strcasecmp ()</h3>
1615
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> g_ascii_strcasecmp (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *s1</code></em>,
1616
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *s2</code></em>);</pre>
1617
- <p>
1618
- Compare two strings, ignoring the case of ASCII characters.
1619
- </p>
1620
- <p>
1621
- Unlike the BSD <code class="function">strcasecmp()</code> function, this only recognizes standard
1622
- ASCII letters and ignores the locale, treating all non-ASCII
1623
- bytes as if they are not letters.
1624
- </p>
1625
- <p>
1626
- This function should be used only on strings that are known to be
1627
- in encodings where the bytes corresponding to ASCII letters always
1628
- represent themselves. This includes UTF-8 and the ISO-8859-*
1629
- charsets, but not for instance double-byte encodings like the
1630
- Windows Codepage 932, where the trailing bytes of double-byte
1631
- characters include all ASCII letters. If you compare two CP932
1632
- strings using this function, you will get false matches.
1633
- </p>
1634
- <div class="variablelist"><table border="0">
1635
- <col align="left" valign="top">
1636
- <tbody>
1637
- <tr>
1638
- <td><p><span class="term"><em class="parameter"><code>s1</code></em> :</span></p></td>
1639
- <td>string to compare with <em class="parameter"><code>s2</code></em>.
1640
- </td>
1641
- </tr>
1642
- <tr>
1643
- <td><p><span class="term"><em class="parameter"><code>s2</code></em> :</span></p></td>
1644
- <td>string to compare with <em class="parameter"><code>s1</code></em>.
1645
- </td>
1646
- </tr>
1647
- <tr>
1648
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1649
- <td> 0 if the strings match, a negative value if <em class="parameter"><code>s1</code></em> &lt; <em class="parameter"><code>s2</code></em>,
1650
- or a positive value if <em class="parameter"><code>s1</code></em> &gt; <em class="parameter"><code>s2</code></em>.
1651
- </td>
1652
- </tr>
1653
- </tbody>
1654
- </table></div>
1655
- </div>
1656
- <hr>
1657
- <div class="refsect2">
1658
- <a name="g-ascii-strncasecmp"></a><h3>g_ascii_strncasecmp ()</h3>
1659
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> g_ascii_strncasecmp (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *s1</code></em>,
1660
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *s2</code></em>,
1661
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> n</code></em>);</pre>
1662
- <p>
1663
- Compare <em class="parameter"><code>s1</code></em> and <em class="parameter"><code>s2</code></em>, ignoring the case of ASCII characters and any
1664
- characters after the first <em class="parameter"><code>n</code></em> in each string.
1665
- </p>
1666
- <p>
1667
- Unlike the BSD <code class="function">strcasecmp()</code> function, this only recognizes standard
1668
- ASCII letters and ignores the locale, treating all non-ASCII
1669
- characters as if they are not letters.
1670
- </p>
1671
- <p>
1672
- The same warning as in <a class="link" href="glib-String-Utility-Functions.html#g-ascii-strcasecmp" title="g_ascii_strcasecmp ()"><code class="function">g_ascii_strcasecmp()</code></a> applies: Use this
1673
- function only on strings known to be in encodings where bytes
1674
- corresponding to ASCII letters always represent themselves.
1675
- </p>
1676
- <div class="variablelist"><table border="0">
1677
- <col align="left" valign="top">
1678
- <tbody>
1679
- <tr>
1680
- <td><p><span class="term"><em class="parameter"><code>s1</code></em> :</span></p></td>
1681
- <td>string to compare with <em class="parameter"><code>s2</code></em>.
1682
- </td>
1683
- </tr>
1684
- <tr>
1685
- <td><p><span class="term"><em class="parameter"><code>s2</code></em> :</span></p></td>
1686
- <td>string to compare with <em class="parameter"><code>s1</code></em>.
1687
- </td>
1688
- </tr>
1689
- <tr>
1690
- <td><p><span class="term"><em class="parameter"><code>n</code></em> :</span></p></td>
1691
- <td>number of characters to compare.
1692
- </td>
1693
- </tr>
1694
- <tr>
1695
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1696
- <td> 0 if the strings match, a negative value if <em class="parameter"><code>s1</code></em> &lt; <em class="parameter"><code>s2</code></em>,
1697
- or a positive value if <em class="parameter"><code>s1</code></em> &gt; <em class="parameter"><code>s2</code></em>.
1698
- </td>
1699
- </tr>
1700
- </tbody>
1701
- </table></div>
1702
- </div>
1703
- <hr>
1704
- <div class="refsect2">
1705
- <a name="g-ascii-strup"></a><h3>g_ascii_strup ()</h3>
1706
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_ascii_strup (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
1707
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> len</code></em>);</pre>
1708
- <p>
1709
- Converts all lower case ASCII letters to upper case ASCII letters.
1710
- </p>
1711
- <div class="variablelist"><table border="0">
1712
- <col align="left" valign="top">
1713
- <tbody>
1714
- <tr>
1715
- <td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
1716
- <td>a string.
1717
- </td>
1718
- </tr>
1719
- <tr>
1720
- <td><p><span class="term"><em class="parameter"><code>len</code></em> :</span></p></td>
1721
- <td>length of <em class="parameter"><code>str</code></em> in bytes, or -1 if <em class="parameter"><code>str</code></em> is nul-terminated.
1722
- </td>
1723
- </tr>
1724
- <tr>
1725
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1726
- <td> a newly allocated string, with all the lower case
1727
- characters in <em class="parameter"><code>str</code></em> converted to upper case, with
1728
- semantics that exactly match <a class="link" href="glib-String-Utility-Functions.html#g-ascii-toupper" title="g_ascii_toupper ()"><code class="function">g_ascii_toupper()</code></a>. (Note
1729
- that this is unlike the old <a class="link" href="glib-String-Utility-Functions.html#g-strup" title="g_strup ()"><code class="function">g_strup()</code></a>, which modified
1730
- the string in place.)
1731
- </td>
1732
- </tr>
1733
- </tbody>
1734
- </table></div>
1735
- </div>
1736
- <hr>
1737
- <div class="refsect2">
1738
- <a name="g-ascii-strdown"></a><h3>g_ascii_strdown ()</h3>
1739
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_ascii_strdown (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
1740
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> len</code></em>);</pre>
1741
- <p>
1742
- Converts all upper case ASCII letters to lower case ASCII letters.
1743
- </p>
1744
- <div class="variablelist"><table border="0">
1745
- <col align="left" valign="top">
1746
- <tbody>
1747
- <tr>
1748
- <td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
1749
- <td>a string.
1750
- </td>
1751
- </tr>
1752
- <tr>
1753
- <td><p><span class="term"><em class="parameter"><code>len</code></em> :</span></p></td>
1754
- <td>length of <em class="parameter"><code>str</code></em> in bytes, or -1 if <em class="parameter"><code>str</code></em> is nul-terminated.
1755
- </td>
1756
- </tr>
1757
- <tr>
1758
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1759
- <td> a newly-allocated string, with all the upper case
1760
- characters in <em class="parameter"><code>str</code></em> converted to lower case, with
1761
- semantics that exactly match <a class="link" href="glib-String-Utility-Functions.html#g-ascii-tolower" title="g_ascii_tolower ()"><code class="function">g_ascii_tolower()</code></a>. (Note
1762
- that this is unlike the old <a class="link" href="glib-String-Utility-Functions.html#g-strdown" title="g_strdown ()"><code class="function">g_strdown()</code></a>, which modified
1763
- the string in place.)
1764
- </td>
1765
- </tr>
1766
- </tbody>
1767
- </table></div>
1768
- </div>
1769
- <hr>
1770
- <div class="refsect2">
1771
- <a name="g-ascii-tolower"></a><h3>g_ascii_tolower ()</h3>
1772
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> g_ascii_tolower (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> c</code></em>);</pre>
1773
- <p>
1774
- Convert a character to ASCII lower case.
1775
- </p>
1776
- <p>
1777
- Unlike the standard C library <code class="function">tolower()</code> function, this only
1778
- recognizes standard ASCII letters and ignores the locale, returning
1779
- all non-ASCII characters unchanged, even if they are lower case
1780
- letters in a particular character set. Also unlike the standard
1781
- library function, this takes and returns a char, not an int, so
1782
- don't call it on <code class="literal">EOF</code> but no need to worry about casting to <a class="link" href="glib-Basic-Types.html#guchar" title="guchar"><span class="type">guchar</span></a>
1783
- before passing a possibly non-ASCII character in.
1784
- </p>
1785
- <div class="variablelist"><table border="0">
1786
- <col align="left" valign="top">
1787
- <tbody>
1788
- <tr>
1789
- <td><p><span class="term"><em class="parameter"><code>c</code></em> :</span></p></td>
1790
- <td>any character.
1791
- </td>
1792
- </tr>
1793
- <tr>
1794
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1795
- <td> the result of converting <em class="parameter"><code>c</code></em> to lower case.
1796
- If <em class="parameter"><code>c</code></em> is not an ASCII upper case letter,
1797
- <em class="parameter"><code>c</code></em> is returned unchanged.
1798
- </td>
1799
- </tr>
1800
- </tbody>
1801
- </table></div>
1802
- </div>
1803
- <hr>
1804
- <div class="refsect2">
1805
- <a name="g-ascii-toupper"></a><h3>g_ascii_toupper ()</h3>
1806
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> g_ascii_toupper (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> c</code></em>);</pre>
1807
- <p>
1808
- Convert a character to ASCII upper case.
1809
- </p>
1810
- <p>
1811
- Unlike the standard C library <code class="function">toupper()</code> function, this only
1812
- recognizes standard ASCII letters and ignores the locale, returning
1813
- all non-ASCII characters unchanged, even if they are upper case
1814
- letters in a particular character set. Also unlike the standard
1815
- library function, this takes and returns a char, not an int, so
1816
- don't call it on <code class="literal">EOF</code> but no need to worry about casting to <a class="link" href="glib-Basic-Types.html#guchar" title="guchar"><span class="type">guchar</span></a>
1817
- before passing a possibly non-ASCII character in.
1818
- </p>
1819
- <div class="variablelist"><table border="0">
1820
- <col align="left" valign="top">
1821
- <tbody>
1822
- <tr>
1823
- <td><p><span class="term"><em class="parameter"><code>c</code></em> :</span></p></td>
1824
- <td>any character.
1825
- </td>
1826
- </tr>
1827
- <tr>
1828
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1829
- <td> the result of converting <em class="parameter"><code>c</code></em> to upper case.
1830
- If <em class="parameter"><code>c</code></em> is not an ASCII lower case letter,
1831
- <em class="parameter"><code>c</code></em> is returned unchanged.
1832
- </td>
1833
- </tr>
1834
- </tbody>
1835
- </table></div>
1836
- </div>
1837
- <hr>
1838
- <div class="refsect2">
1839
- <a name="g-string-ascii-up"></a><h3>g_string_ascii_up ()</h3>
1840
- <pre class="programlisting"><a class="link" href="glib-Strings.html#GString" title="GString"><span class="returnvalue">GString</span></a> * g_string_ascii_up (<em class="parameter"><code><a class="link" href="glib-Strings.html#GString" title="GString"><span class="type">GString</span></a> *string</code></em>);</pre>
1841
- <p>
1842
- Converts all lower case ASCII letters to upper case ASCII letters.
1843
- </p>
1844
- <div class="variablelist"><table border="0">
1845
- <col align="left" valign="top">
1846
- <tbody>
1847
- <tr>
1848
- <td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
1849
- <td>a GString
1850
- </td>
1851
- </tr>
1852
- <tr>
1853
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1854
- <td> passed-in <em class="parameter"><code>string</code></em> pointer, with all the lower case
1855
- characters converted to upper case in place, with
1856
- semantics that exactly match <a class="link" href="glib-String-Utility-Functions.html#g-ascii-toupper" title="g_ascii_toupper ()"><code class="function">g_ascii_toupper()</code></a>.
1857
- </td>
1858
- </tr>
1859
- </tbody>
1860
- </table></div>
1861
- </div>
1862
- <hr>
1863
- <div class="refsect2">
1864
- <a name="g-string-ascii-down"></a><h3>g_string_ascii_down ()</h3>
1865
- <pre class="programlisting"><a class="link" href="glib-Strings.html#GString" title="GString"><span class="returnvalue">GString</span></a> * g_string_ascii_down (<em class="parameter"><code><a class="link" href="glib-Strings.html#GString" title="GString"><span class="type">GString</span></a> *string</code></em>);</pre>
1866
- <p>
1867
- Converts all upper case ASCII letters to lower case ASCII letters.
1868
- </p>
1869
- <div class="variablelist"><table border="0">
1870
- <col align="left" valign="top">
1871
- <tbody>
1872
- <tr>
1873
- <td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
1874
- <td>a GString
1875
- </td>
1876
- </tr>
1877
- <tr>
1878
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1879
- <td> passed-in <em class="parameter"><code>string</code></em> pointer, with all the upper case
1880
- characters converted to lower case in place, with
1881
- semantics that exactly match <a class="link" href="glib-String-Utility-Functions.html#g-ascii-tolower" title="g_ascii_tolower ()"><code class="function">g_ascii_tolower()</code></a>.
1882
- </td>
1883
- </tr>
1884
- </tbody>
1885
- </table></div>
1886
- </div>
1887
- <hr>
1888
- <div class="refsect2">
1889
- <a name="g-strup"></a><h3>g_strup ()</h3>
1890
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_strup (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *string</code></em>);</pre>
1891
- <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1892
- <h3 class="title">Warning</h3>
1893
- <p><code class="literal">g_strup</code> has been deprecated since version 2.2 and should not be used in newly-written code. This function is totally broken for the reasons discussed
1894
- in the <a class="link" href="glib-String-Utility-Functions.html#g-strncasecmp" title="g_strncasecmp ()"><code class="function">g_strncasecmp()</code></a> docs - use <a class="link" href="glib-String-Utility-Functions.html#g-ascii-strup" title="g_ascii_strup ()"><code class="function">g_ascii_strup()</code></a> or <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-strup" title="g_utf8_strup ()"><code class="function">g_utf8_strup()</code></a> instead.</p>
1895
- </div>
1896
- <p>
1897
- Converts a string to upper case.
1898
- </p>
1899
- <div class="variablelist"><table border="0">
1900
- <col align="left" valign="top">
1901
- <tbody>
1902
- <tr>
1903
- <td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
1904
- <td>the string to convert.
1905
- </td>
1906
- </tr>
1907
- <tr>
1908
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1909
- <td> the string
1910
-
1911
- </td>
1912
- </tr>
1913
- </tbody>
1914
- </table></div>
1915
- </div>
1916
- <hr>
1917
- <div class="refsect2">
1918
- <a name="g-strdown"></a><h3>g_strdown ()</h3>
1919
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_strdown (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *string</code></em>);</pre>
1920
- <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1921
- <h3 class="title">Warning</h3>
1922
- <p><code class="literal">g_strdown</code> has been deprecated since version 2.2 and should not be used in newly-written code. This function is totally broken for the reasons discussed
1923
- in the <a class="link" href="glib-String-Utility-Functions.html#g-strncasecmp" title="g_strncasecmp ()"><code class="function">g_strncasecmp()</code></a> docs - use <a class="link" href="glib-String-Utility-Functions.html#g-ascii-strdown" title="g_ascii_strdown ()"><code class="function">g_ascii_strdown()</code></a> or <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-strdown" title="g_utf8_strdown ()"><code class="function">g_utf8_strdown()</code></a>
1924
- instead.</p>
1925
- </div>
1926
- <p>
1927
- Converts a string to lower case.
1928
- </p>
1929
- <div class="variablelist"><table border="0">
1930
- <col align="left" valign="top">
1931
- <tbody>
1932
- <tr>
1933
- <td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
1934
- <td>the string to convert.
1935
- </td>
1936
- </tr>
1937
- <tr>
1938
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1939
- <td> the string
1940
-
1941
- </td>
1942
- </tr>
1943
- </tbody>
1944
- </table></div>
1945
- </div>
1946
- <hr>
1947
- <div class="refsect2">
1948
- <a name="g-strcasecmp"></a><h3>g_strcasecmp ()</h3>
1949
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> g_strcasecmp (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *s1</code></em>,
1950
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *s2</code></em>);</pre>
1951
- <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1952
- <h3 class="title">Warning</h3>
1953
- <p><code class="literal">g_strcasecmp</code> has been deprecated since version 2.2 and should not be used in newly-written code. See <a class="link" href="glib-String-Utility-Functions.html#g-strncasecmp" title="g_strncasecmp ()"><code class="function">g_strncasecmp()</code></a> for a discussion of why this function
1954
- is deprecated and how to replace it.</p>
1955
- </div>
1956
- <p>
1957
- A case-insensitive string comparison, corresponding to the standard
1958
- <code class="function">strcasecmp()</code> function on platforms which support it.
1959
- </p>
1960
- <div class="variablelist"><table border="0">
1961
- <col align="left" valign="top">
1962
- <tbody>
1963
- <tr>
1964
- <td><p><span class="term"><em class="parameter"><code>s1</code></em> :</span></p></td>
1965
- <td>a string.
1966
- </td>
1967
- </tr>
1968
- <tr>
1969
- <td><p><span class="term"><em class="parameter"><code>s2</code></em> :</span></p></td>
1970
- <td>a string to compare with <em class="parameter"><code>s1</code></em>.
1971
- </td>
1972
- </tr>
1973
- <tr>
1974
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1975
- <td> 0 if the strings match, a negative value if <em class="parameter"><code>s1</code></em> &lt; <em class="parameter"><code>s2</code></em>,
1976
- or a positive value if <em class="parameter"><code>s1</code></em> &gt; <em class="parameter"><code>s2</code></em>.
1977
-
1978
- </td>
1979
- </tr>
1980
- </tbody>
1981
- </table></div>
1982
- </div>
1983
- <hr>
1984
- <div class="refsect2">
1985
- <a name="g-strncasecmp"></a><h3>g_strncasecmp ()</h3>
1986
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> g_strncasecmp (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *s1</code></em>,
1987
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *s2</code></em>,
1988
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="type">guint</span></a> n</code></em>);</pre>
1989
- <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1990
- <h3 class="title">Warning</h3>
1991
- <p><code class="literal">g_strncasecmp</code> has been deprecated since version 2.2 and should not be used in newly-written code. The problem with <a class="link" href="glib-String-Utility-Functions.html#g-strncasecmp" title="g_strncasecmp ()"><code class="function">g_strncasecmp()</code></a> is that it does the
1992
- comparison by calling <code class="function">toupper()</code>/<code class="function">tolower()</code>. These functions are
1993
- locale-specific and operate on single bytes. However, it is impossible
1994
- to handle things correctly from an I18N standpoint by operating on
1995
- bytes, since characters may be multibyte. Thus <a class="link" href="glib-String-Utility-Functions.html#g-strncasecmp" title="g_strncasecmp ()"><code class="function">g_strncasecmp()</code></a> is
1996
- broken if your string is guaranteed to be ASCII, since it's
1997
- locale-sensitive, and it's broken if your string is localized, since
1998
- it doesn't work on many encodings at all, including UTF-8, EUC-JP,
1999
- etc.
2000
- </p>
2001
- <p>
2002
- There are therefore two replacement functions: <a class="link" href="glib-String-Utility-Functions.html#g-ascii-strncasecmp" title="g_ascii_strncasecmp ()"><code class="function">g_ascii_strncasecmp()</code></a>,
2003
- which only works on ASCII and is not locale-sensitive, and
2004
- <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-casefold" title="g_utf8_casefold ()"><code class="function">g_utf8_casefold()</code></a>, which is good for case-insensitive sorting of UTF-8.</p>
2005
- </div>
2006
- <p>
2007
- A case-insensitive string comparison, corresponding to the standard
2008
- <code class="function">strncasecmp()</code> function on platforms which support it.
2009
- It is similar to <a class="link" href="glib-String-Utility-Functions.html#g-strcasecmp" title="g_strcasecmp ()"><code class="function">g_strcasecmp()</code></a> except it only compares the first <em class="parameter"><code>n</code></em>
2010
- characters of the strings.
2011
- </p>
2012
- <div class="variablelist"><table border="0">
2013
- <col align="left" valign="top">
2014
- <tbody>
2015
- <tr>
2016
- <td><p><span class="term"><em class="parameter"><code>s1</code></em> :</span></p></td>
2017
- <td>a string.
2018
- </td>
2019
- </tr>
2020
- <tr>
2021
- <td><p><span class="term"><em class="parameter"><code>s2</code></em> :</span></p></td>
2022
- <td>a string to compare with <em class="parameter"><code>s1</code></em>.
2023
- </td>
2024
- </tr>
2025
- <tr>
2026
- <td><p><span class="term"><em class="parameter"><code>n</code></em> :</span></p></td>
2027
- <td>the maximum number of characters to compare.
2028
- </td>
2029
- </tr>
2030
- <tr>
2031
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2032
- <td> 0 if the strings match, a negative value if <em class="parameter"><code>s1</code></em> &lt; <em class="parameter"><code>s2</code></em>,
2033
- or a positive value if <em class="parameter"><code>s1</code></em> &gt; <em class="parameter"><code>s2</code></em>.
2034
-
2035
- </td>
2036
- </tr>
2037
- </tbody>
2038
- </table></div>
2039
- </div>
2040
- <hr>
2041
- <div class="refsect2">
2042
- <a name="g-strreverse"></a><h3>g_strreverse ()</h3>
2043
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_strreverse (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *string</code></em>);</pre>
2044
- <p>
2045
- Reverses all of the bytes in a string. For example,
2046
- <code class="literal">g_strreverse ("abcdef")</code> will result
2047
- in "fedcba".
2048
- </p>
2049
- <p>
2050
- Note that <a class="link" href="glib-String-Utility-Functions.html#g-strreverse" title="g_strreverse ()"><code class="function">g_strreverse()</code></a> doesn't work on UTF-8 strings
2051
- containing multibyte characters. For that purpose, use
2052
- <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-strreverse" title="g_utf8_strreverse ()"><code class="function">g_utf8_strreverse()</code></a>.
2053
- </p>
2054
- <div class="variablelist"><table border="0">
2055
- <col align="left" valign="top">
2056
- <tbody>
2057
- <tr>
2058
- <td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
2059
- <td>the string to reverse
2060
- </td>
2061
- </tr>
2062
- <tr>
2063
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2064
- <td> the same pointer passed in as <em class="parameter"><code>string</code></em>
2065
- </td>
2066
- </tr>
2067
- </tbody>
2068
- </table></div>
2069
- </div>
2070
- <hr>
2071
- <div class="refsect2">
2072
- <a name="g-ascii-strtoll"></a><h3>g_ascii_strtoll ()</h3>
2073
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint64" title="gint64"><span class="returnvalue">gint64</span></a> g_ascii_strtoll (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *nptr</code></em>,
2074
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **endptr</code></em>,
2075
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="type">guint</span></a> base</code></em>);</pre>
2076
- <p>
2077
- Converts a string to a <a class="link" href="glib-Basic-Types.html#gint64" title="gint64"><span class="type">gint64</span></a> value.
2078
- This function behaves like the standard <code class="function">strtoll()</code> function
2079
- does in the C locale. It does this without actually
2080
- changing the current locale, since that would not be
2081
- thread-safe.
2082
- </p>
2083
- <p>
2084
- This function is typically used when reading configuration
2085
- files or other non-user input that should be locale independent.
2086
- To handle input from the user you should normally use the
2087
- locale-sensitive system <code class="function">strtoll()</code> function.
2088
- </p>
2089
- <p>
2090
- If the correct value would cause overflow, <a class="link" href="glib-Limits-of-Basic-Types.html#G-MAXINT64:CAPS" title="G_MAXINT64"><code class="literal">G_MAXINT64</code></a> or <a class="link" href="glib-Limits-of-Basic-Types.html#G-MININT64:CAPS" title="G_MININT64"><code class="literal">G_MININT64</code></a>
2091
- is returned, and <code class="literal">ERANGE</code> is stored in <code class="literal">errno</code>. If the base is
2092
- outside the valid range, zero is returned, and <code class="literal">EINVAL</code> is stored
2093
- in <code class="literal">errno</code>. If the string conversion fails, zero is returned, and
2094
- <em class="parameter"><code>endptr</code></em> returns <em class="parameter"><code>nptr</code></em> (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>).
2095
- </p>
2096
- <div class="variablelist"><table border="0">
2097
- <col align="left" valign="top">
2098
- <tbody>
2099
- <tr>
2100
- <td><p><span class="term"><em class="parameter"><code>nptr</code></em> :</span></p></td>
2101
- <td>the string to convert to a numeric value.
2102
- </td>
2103
- </tr>
2104
- <tr>
2105
- <td><p><span class="term"><em class="parameter"><code>endptr</code></em> :</span></p></td>
2106
- <td>if non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, it returns the character after
2107
- the last character used in the conversion.
2108
- </td>
2109
- </tr>
2110
- <tr>
2111
- <td><p><span class="term"><em class="parameter"><code>base</code></em> :</span></p></td>
2112
- <td>to be used for the conversion, 2..36 or 0
2113
- </td>
2114
- </tr>
2115
- <tr>
2116
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2117
- <td> the <a class="link" href="glib-Basic-Types.html#gint64" title="gint64"><span class="type">gint64</span></a> value or zero on error.
2118
-
2119
- </td>
2120
- </tr>
2121
- </tbody>
2122
- </table></div>
2123
- <p class="since">Since 2.12</p>
2124
- </div>
2125
- <hr>
2126
- <div class="refsect2">
2127
- <a name="g-ascii-strtoull"></a><h3>g_ascii_strtoull ()</h3>
2128
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint64" title="guint64"><span class="returnvalue">guint64</span></a> g_ascii_strtoull (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *nptr</code></em>,
2129
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **endptr</code></em>,
2130
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="type">guint</span></a> base</code></em>);</pre>
2131
- <p>
2132
- Converts a string to a <a class="link" href="glib-Basic-Types.html#guint64" title="guint64"><span class="type">guint64</span></a> value.
2133
- This function behaves like the standard <code class="function">strtoull()</code> function
2134
- does in the C locale. It does this without actually
2135
- changing the current locale, since that would not be
2136
- thread-safe.
2137
- </p>
2138
- <p>
2139
- This function is typically used when reading configuration
2140
- files or other non-user input that should be locale independent.
2141
- To handle input from the user you should normally use the
2142
- locale-sensitive system <code class="function">strtoull()</code> function.
2143
- </p>
2144
- <p>
2145
- If the correct value would cause overflow, <a class="link" href="glib-Limits-of-Basic-Types.html#G-MAXUINT64:CAPS" title="G_MAXUINT64"><code class="literal">G_MAXUINT64</code></a>
2146
- is returned, and <code class="literal">ERANGE</code> is stored in <code class="literal">errno</code>. If the base is
2147
- outside the valid range, zero is returned, and <code class="literal">EINVAL</code> is stored
2148
- in <code class="literal">errno</code>. If the string conversion fails, zero is returned, and
2149
- <em class="parameter"><code>endptr</code></em> returns <em class="parameter"><code>nptr</code></em> (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>).
2150
- </p>
2151
- <div class="variablelist"><table border="0">
2152
- <col align="left" valign="top">
2153
- <tbody>
2154
- <tr>
2155
- <td><p><span class="term"><em class="parameter"><code>nptr</code></em> :</span></p></td>
2156
- <td>the string to convert to a numeric value.
2157
- </td>
2158
- </tr>
2159
- <tr>
2160
- <td><p><span class="term"><em class="parameter"><code>endptr</code></em> :</span></p></td>
2161
- <td>if non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, it returns the character after
2162
- the last character used in the conversion.
2163
- </td>
2164
- </tr>
2165
- <tr>
2166
- <td><p><span class="term"><em class="parameter"><code>base</code></em> :</span></p></td>
2167
- <td>to be used for the conversion, 2..36 or 0
2168
- </td>
2169
- </tr>
2170
- <tr>
2171
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2172
- <td> the <a class="link" href="glib-Basic-Types.html#guint64" title="guint64"><span class="type">guint64</span></a> value or zero on error.
2173
-
2174
- </td>
2175
- </tr>
2176
- </tbody>
2177
- </table></div>
2178
- <p class="since">Since 2.2</p>
2179
- </div>
2180
- <hr>
2181
- <div class="refsect2">
2182
- <a name="G-ASCII-DTOSTR-BUF-SIZE:CAPS"></a><h3>G_ASCII_DTOSTR_BUF_SIZE</h3>
2183
- <pre class="programlisting">#define G_ASCII_DTOSTR_BUF_SIZE (29 + 10)
2184
- </pre>
2185
- <p>
2186
- A good size for a buffer to be passed into <a class="link" href="glib-String-Utility-Functions.html#g-ascii-dtostr" title="g_ascii_dtostr ()"><code class="function">g_ascii_dtostr()</code></a>.
2187
- It is guaranteed to be enough for all output of that function on systems with
2188
- 64bit IEEE-compatible doubles.
2189
- </p>
2190
- <p>
2191
- The typical usage would be something like:
2192
- </p>
2193
- <div class="informalexample">
2194
- <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
2195
- <tbody>
2196
- <tr>
2197
- <td class="listing_lines" align="right"><pre>1
2198
- 2</pre></td>
2199
- <td class="listing_code"><pre class="programlisting"><span class="type">char</span><span class="normal"> buf</span><span class="symbol">[</span><span class="normal"><a href="glib-String-Utility-Functions.html#G-ASCII-DTOSTR-BUF-SIZE:CAPS">G_ASCII_DTOSTR_BUF_SIZE</a></span><span class="symbol">];</span>
2200
- <span class="function">fprintf</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">out</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"value=%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-String-Utility-Functions.html#g-ascii-dtostr">g_ascii_dtostr</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">buf</span><span class="symbol">,</span><span class="normal"> </span><span class="keyword">sizeof</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">buf</span><span class="symbol">),</span><span class="normal"> value</span><span class="symbol">));</span></pre></td>
2201
- </tr>
2202
- </tbody>
2203
- </table>
2204
- </div>
2205
-
2206
- <p>
2207
- </p>
2208
- </div>
2209
- <hr>
2210
- <div class="refsect2">
2211
- <a name="g-ascii-strtod"></a><h3>g_ascii_strtod ()</h3>
2212
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gdouble" title="gdouble"><span class="returnvalue">gdouble</span></a> g_ascii_strtod (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *nptr</code></em>,
2213
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **endptr</code></em>);</pre>
2214
- <p>
2215
- Converts a string to a <a class="link" href="glib-Basic-Types.html#gdouble" title="gdouble"><span class="type">gdouble</span></a> value.
2216
- </p>
2217
- <p>
2218
- This function behaves like the standard <code class="function">strtod()</code> function
2219
- does in the C locale. It does this without actually changing
2220
- the current locale, since that would not be thread-safe.
2221
- A limitation of the implementation is that this function
2222
- will still accept localized versions of infinities and NANs.
2223
- </p>
2224
- <p>
2225
- This function is typically used when reading configuration
2226
- files or other non-user input that should be locale independent.
2227
- To handle input from the user you should normally use the
2228
- locale-sensitive system <code class="function">strtod()</code> function.
2229
- </p>
2230
- <p>
2231
- To convert from a <a class="link" href="glib-Basic-Types.html#gdouble" title="gdouble"><span class="type">gdouble</span></a> to a string in a locale-insensitive
2232
- way, use <a class="link" href="glib-String-Utility-Functions.html#g-ascii-dtostr" title="g_ascii_dtostr ()"><code class="function">g_ascii_dtostr()</code></a>.
2233
- </p>
2234
- <p>
2235
- If the correct value would cause overflow, plus or minus <code class="literal">HUGE_VAL</code>
2236
- is returned (according to the sign of the value), and <code class="literal">ERANGE</code> is
2237
- stored in <code class="literal">errno</code>. If the correct value would cause underflow,
2238
- zero is returned and <code class="literal">ERANGE</code> is stored in <code class="literal">errno</code>.
2239
- </p>
2240
- <p>
2241
- This function resets <code class="literal">errno</code> before calling <code class="function">strtod()</code> so that
2242
- you can reliably detect overflow and underflow.
2243
- </p>
2244
- <div class="variablelist"><table border="0">
2245
- <col align="left" valign="top">
2246
- <tbody>
2247
- <tr>
2248
- <td><p><span class="term"><em class="parameter"><code>nptr</code></em> :</span></p></td>
2249
- <td>the string to convert to a numeric value.
2250
- </td>
2251
- </tr>
2252
- <tr>
2253
- <td><p><span class="term"><em class="parameter"><code>endptr</code></em> :</span></p></td>
2254
- <td>if non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, it returns the character after
2255
- the last character used in the conversion.
2256
- </td>
2257
- </tr>
2258
- <tr>
2259
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2260
- <td> the <a class="link" href="glib-Basic-Types.html#gdouble" title="gdouble"><span class="type">gdouble</span></a> value.
2261
- </td>
2262
- </tr>
2263
- </tbody>
2264
- </table></div>
2265
- </div>
2266
- <hr>
2267
- <div class="refsect2">
2268
- <a name="g-ascii-dtostr"></a><h3>g_ascii_dtostr ()</h3>
2269
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_ascii_dtostr (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *buffer</code></em>,
2270
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> buf_len</code></em>,
2271
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gdouble" title="gdouble"><span class="type">gdouble</span></a> d</code></em>);</pre>
2272
- <p>
2273
- Converts a <a class="link" href="glib-Basic-Types.html#gdouble" title="gdouble"><span class="type">gdouble</span></a> to a string, using the '.' as
2274
- decimal point.
2275
- </p>
2276
- <p>
2277
- This functions generates enough precision that converting
2278
- the string back using <a class="link" href="glib-String-Utility-Functions.html#g-ascii-strtod" title="g_ascii_strtod ()"><code class="function">g_ascii_strtod()</code></a> gives the same machine-number
2279
- (on machines with IEEE compatible 64bit doubles). It is
2280
- guaranteed that the size of the resulting string will never
2281
- be larger than <em class="parameter"><code>G_ASCII_DTOSTR_BUF_SIZE</code></em> bytes.
2282
- </p>
2283
- <div class="variablelist"><table border="0">
2284
- <col align="left" valign="top">
2285
- <tbody>
2286
- <tr>
2287
- <td><p><span class="term"><em class="parameter"><code>buffer</code></em> :</span></p></td>
2288
- <td>A buffer to place the resulting string in
2289
- </td>
2290
- </tr>
2291
- <tr>
2292
- <td><p><span class="term"><em class="parameter"><code>buf_len</code></em> :</span></p></td>
2293
- <td>The length of the buffer.
2294
- </td>
2295
- </tr>
2296
- <tr>
2297
- <td><p><span class="term"><em class="parameter"><code>d</code></em> :</span></p></td>
2298
- <td>The <a class="link" href="glib-Basic-Types.html#gdouble" title="gdouble"><span class="type">gdouble</span></a> to convert
2299
- </td>
2300
- </tr>
2301
- <tr>
2302
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2303
- <td> The pointer to the buffer with the converted string.
2304
- </td>
2305
- </tr>
2306
- </tbody>
2307
- </table></div>
2308
- </div>
2309
- <hr>
2310
- <div class="refsect2">
2311
- <a name="g-ascii-formatd"></a><h3>g_ascii_formatd ()</h3>
2312
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_ascii_formatd (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *buffer</code></em>,
2313
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> buf_len</code></em>,
2314
- <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>,
2315
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gdouble" title="gdouble"><span class="type">gdouble</span></a> d</code></em>);</pre>
2316
- <p>
2317
- Converts a <a class="link" href="glib-Basic-Types.html#gdouble" title="gdouble"><span class="type">gdouble</span></a> to a string, using the '.' as
2318
- decimal point. To format the number you pass in
2319
- a <code class="function">printf()</code>-style format string. Allowed conversion
2320
- specifiers are 'e', 'E', 'f', 'F', 'g' and 'G'.
2321
- </p>
2322
- <p>
2323
- If you just want to want to serialize the value into a
2324
- string, use <a class="link" href="glib-String-Utility-Functions.html#g-ascii-dtostr" title="g_ascii_dtostr ()"><code class="function">g_ascii_dtostr()</code></a>.
2325
- </p>
2326
- <div class="variablelist"><table border="0">
2327
- <col align="left" valign="top">
2328
- <tbody>
2329
- <tr>
2330
- <td><p><span class="term"><em class="parameter"><code>buffer</code></em> :</span></p></td>
2331
- <td>A buffer to place the resulting string in
2332
- </td>
2333
- </tr>
2334
- <tr>
2335
- <td><p><span class="term"><em class="parameter"><code>buf_len</code></em> :</span></p></td>
2336
- <td>The length of the buffer.
2337
- </td>
2338
- </tr>
2339
- <tr>
2340
- <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
2341
- <td>The <code class="function">printf()</code>-style format to use for the
2342
- code to use for converting.
2343
- </td>
2344
- </tr>
2345
- <tr>
2346
- <td><p><span class="term"><em class="parameter"><code>d</code></em> :</span></p></td>
2347
- <td>The <a class="link" href="glib-Basic-Types.html#gdouble" title="gdouble"><span class="type">gdouble</span></a> to convert
2348
- </td>
2349
- </tr>
2350
- <tr>
2351
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2352
- <td> The pointer to the buffer with the converted string.
2353
- </td>
2354
- </tr>
2355
- </tbody>
2356
- </table></div>
2357
- </div>
2358
- <hr>
2359
- <div class="refsect2">
2360
- <a name="g-strtod"></a><h3>g_strtod ()</h3>
2361
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gdouble" title="gdouble"><span class="returnvalue">gdouble</span></a> g_strtod (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *nptr</code></em>,
2362
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **endptr</code></em>);</pre>
2363
- <p>
2364
- Converts a string to a <a class="link" href="glib-Basic-Types.html#gdouble" title="gdouble"><span class="type">gdouble</span></a> value.
2365
- It calls the standard <code class="function">strtod()</code> function to handle the conversion, but
2366
- if the string is not completely converted it attempts the conversion
2367
- again with <a class="link" href="glib-String-Utility-Functions.html#g-ascii-strtod" title="g_ascii_strtod ()"><code class="function">g_ascii_strtod()</code></a>, and returns the best match.
2368
- </p>
2369
- <p>
2370
- This function should seldomly be used. The normal situation when reading
2371
- numbers not for human consumption is to use <a class="link" href="glib-String-Utility-Functions.html#g-ascii-strtod" title="g_ascii_strtod ()"><code class="function">g_ascii_strtod()</code></a>. Only when
2372
- you know that you must expect both locale formatted and C formatted numbers
2373
- should you use this. Make sure that you don't pass strings such as comma
2374
- separated lists of values, since the commas may be interpreted as a decimal
2375
- point in some locales, causing unexpected results.
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>nptr</code></em> :</span></p></td>
2382
- <td>the string to convert to a numeric value.
2383
- </td>
2384
- </tr>
2385
- <tr>
2386
- <td><p><span class="term"><em class="parameter"><code>endptr</code></em> :</span></p></td>
2387
- <td>if non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, it returns the character after
2388
- the last character used in the conversion.
2389
- </td>
2390
- </tr>
2391
- <tr>
2392
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2393
- <td> the <a class="link" href="glib-Basic-Types.html#gdouble" title="gdouble"><span class="type">gdouble</span></a> value.
2394
- </td>
2395
- </tr>
2396
- </tbody>
2397
- </table></div>
2398
- </div>
2399
- <hr>
2400
- <div class="refsect2">
2401
- <a name="g-strchug"></a><h3>g_strchug ()</h3>
2402
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_strchug (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *string</code></em>);</pre>
2403
- <p>
2404
- Removes leading whitespace from a string, by moving the rest of the
2405
- characters forward.
2406
- </p>
2407
- <p>
2408
- This function doesn't allocate or reallocate any memory; it modifies <em class="parameter"><code>string</code></em>
2409
- in place. The pointer to <em class="parameter"><code>string</code></em> is returned to allow the nesting of functions.
2410
- </p>
2411
- <p>
2412
- Also see <a class="link" href="glib-String-Utility-Functions.html#g-strchomp" title="g_strchomp ()"><code class="function">g_strchomp()</code></a> and <a class="link" href="glib-String-Utility-Functions.html#g-strstrip" title="g_strstrip()"><code class="function">g_strstrip()</code></a>.
2413
- </p>
2414
- <div class="variablelist"><table border="0">
2415
- <col align="left" valign="top">
2416
- <tbody>
2417
- <tr>
2418
- <td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
2419
- <td>a string to remove the leading whitespace from.
2420
- </td>
2421
- </tr>
2422
- <tr>
2423
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2424
- <td>
2425
- <em class="parameter"><code>string</code></em>.
2426
- </td>
2427
- </tr>
2428
- </tbody>
2429
- </table></div>
2430
- </div>
2431
- <hr>
2432
- <div class="refsect2">
2433
- <a name="g-strchomp"></a><h3>g_strchomp ()</h3>
2434
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_strchomp (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *string</code></em>);</pre>
2435
- <p>
2436
- Removes trailing whitespace from a string.
2437
- </p>
2438
- <p>
2439
- This function doesn't allocate or reallocate any memory; it modifies <em class="parameter"><code>string</code></em> in
2440
- place. The pointer to <em class="parameter"><code>string</code></em> is returned to allow the nesting of functions.
2441
- </p>
2442
- <p>
2443
- Also see <a class="link" href="glib-String-Utility-Functions.html#g-strchug" title="g_strchug ()"><code class="function">g_strchug()</code></a> and <a class="link" href="glib-String-Utility-Functions.html#g-strstrip" title="g_strstrip()"><code class="function">g_strstrip()</code></a>.
2444
- </p>
2445
- <div class="variablelist"><table border="0">
2446
- <col align="left" valign="top">
2447
- <tbody>
2448
- <tr>
2449
- <td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
2450
- <td>a string to remove the trailing whitespace from.
2451
- </td>
2452
- </tr>
2453
- <tr>
2454
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2455
- <td>
2456
- <em class="parameter"><code>string</code></em>.
2457
- </td>
2458
- </tr>
2459
- </tbody>
2460
- </table></div>
2461
- </div>
2462
- <hr>
2463
- <div class="refsect2">
2464
- <a name="g-strstrip"></a><h3>g_strstrip()</h3>
2465
- <pre class="programlisting">#define g_strstrip( string )</pre>
2466
- <p>
2467
- Removes leading and trailing whitespace from a string. See <a class="link" href="glib-String-Utility-Functions.html#g-strchomp" title="g_strchomp ()"><code class="function">g_strchomp()</code></a> and
2468
- <a class="link" href="glib-String-Utility-Functions.html#g-strchug" title="g_strchug ()"><code class="function">g_strchug()</code></a>.
2469
- </p>
2470
- <div class="variablelist"><table border="0">
2471
- <col align="left" valign="top">
2472
- <tbody><tr>
2473
- <td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
2474
- <td>a string to remove the leading and trailing whitespace from.
2475
- </td>
2476
- </tr></tbody>
2477
- </table></div>
2478
- </div>
2479
- <hr>
2480
- <div class="refsect2">
2481
- <a name="g-strdelimit"></a><h3>g_strdelimit ()</h3>
2482
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_strdelimit (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *string</code></em>,
2483
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *delimiters</code></em>,
2484
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> new_delimiter</code></em>);</pre>
2485
- <p>
2486
- Converts any delimiter characters in <em class="parameter"><code>string</code></em> to <em class="parameter"><code>new_delimiter</code></em>.
2487
- Any characters in <em class="parameter"><code>string</code></em> which are found in <em class="parameter"><code>delimiters</code></em> are changed
2488
- to the <em class="parameter"><code>new_delimiter</code></em> character. Modifies <em class="parameter"><code>string</code></em> in place, and returns
2489
- <em class="parameter"><code>string</code></em> itself, not a copy. The return value is to allow nesting such as
2490
- <code class="literal">g_ascii_strup (g_strdelimit (str, "abc", '?'))</code>.
2491
- </p>
2492
- <div class="variablelist"><table border="0">
2493
- <col align="left" valign="top">
2494
- <tbody>
2495
- <tr>
2496
- <td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
2497
- <td>the string to convert.
2498
- </td>
2499
- </tr>
2500
- <tr>
2501
- <td><p><span class="term"><em class="parameter"><code>delimiters</code></em> :</span></p></td>
2502
- <td>a string containing the current delimiters, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> to use the
2503
- standard delimiters defined in <a class="link" href="glib-String-Utility-Functions.html#G-STR-DELIMITERS:CAPS" title="G_STR_DELIMITERS"><span class="type">G_STR_DELIMITERS</span></a>.
2504
- </td>
2505
- </tr>
2506
- <tr>
2507
- <td><p><span class="term"><em class="parameter"><code>new_delimiter</code></em> :</span></p></td>
2508
- <td>the new delimiter character.
2509
- </td>
2510
- </tr>
2511
- <tr>
2512
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2513
- <td>
2514
- <em class="parameter"><code>string</code></em>.
2515
- </td>
2516
- </tr>
2517
- </tbody>
2518
- </table></div>
2519
- </div>
2520
- <hr>
2521
- <div class="refsect2">
2522
- <a name="G-STR-DELIMITERS:CAPS"></a><h3>G_STR_DELIMITERS</h3>
2523
- <pre class="programlisting">#define G_STR_DELIMITERS "_-|&gt; &lt;."
2524
- </pre>
2525
- <p>
2526
- The standard delimiters, used in <a class="link" href="glib-String-Utility-Functions.html#g-strdelimit" title="g_strdelimit ()"><code class="function">g_strdelimit()</code></a>.
2527
- </p>
2528
- </div>
2529
- <hr>
2530
- <div class="refsect2">
2531
- <a name="g-strescape"></a><h3>g_strescape ()</h3>
2532
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_strescape (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *source</code></em>,
2533
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *exceptions</code></em>);</pre>
2534
- <p>
2535
- Escapes the special characters '\b', '\f', '\n', '\r', '\t', '\' and
2536
- '"' in the string <em class="parameter"><code>source</code></em> by inserting a '\' before
2537
- them. Additionally all characters in the range 0x01-0x1F (everything
2538
- below SPACE) and in the range 0x7F-0xFF (all non-ASCII chars) are
2539
- replaced with a '\' followed by their octal representation. Characters
2540
- supplied in <em class="parameter"><code>exceptions</code></em> are not escaped.
2541
- </p>
2542
- <p>
2543
- <a class="link" href="glib-String-Utility-Functions.html#g-strcompress" title="g_strcompress ()"><code class="function">g_strcompress()</code></a> does the reverse conversion.
2544
- </p>
2545
- <div class="variablelist"><table border="0">
2546
- <col align="left" valign="top">
2547
- <tbody>
2548
- <tr>
2549
- <td><p><span class="term"><em class="parameter"><code>source</code></em> :</span></p></td>
2550
- <td>a string to escape.
2551
- </td>
2552
- </tr>
2553
- <tr>
2554
- <td><p><span class="term"><em class="parameter"><code>exceptions</code></em> :</span></p></td>
2555
- <td>a string of characters not to escape in <em class="parameter"><code>source</code></em>.
2556
- </td>
2557
- </tr>
2558
- <tr>
2559
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2560
- <td>a newly-allocated copy of <em class="parameter"><code>source</code></em> with certain
2561
- characters escaped. See above.
2562
- </td>
2563
- </tr>
2564
- </tbody>
2565
- </table></div>
2566
- </div>
2567
- <hr>
2568
- <div class="refsect2">
2569
- <a name="g-strcompress"></a><h3>g_strcompress ()</h3>
2570
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_strcompress (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *source</code></em>);</pre>
2571
- <p>
2572
- Replaces all escaped characters with their one byte equivalent. It
2573
- does the reverse conversion of <a class="link" href="glib-String-Utility-Functions.html#g-strescape" title="g_strescape ()"><code class="function">g_strescape()</code></a>.
2574
- </p>
2575
- <div class="variablelist"><table border="0">
2576
- <col align="left" valign="top">
2577
- <tbody>
2578
- <tr>
2579
- <td><p><span class="term"><em class="parameter"><code>source</code></em> :</span></p></td>
2580
- <td>a string to compress.
2581
- </td>
2582
- </tr>
2583
- <tr>
2584
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2585
- <td>a newly-allocated copy of <em class="parameter"><code>source</code></em> with all escaped
2586
- character compressed.
2587
- </td>
2588
- </tr>
2589
- </tbody>
2590
- </table></div>
2591
- </div>
2592
- <hr>
2593
- <div class="refsect2">
2594
- <a name="g-strcanon"></a><h3>g_strcanon ()</h3>
2595
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_strcanon (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *string</code></em>,
2596
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *valid_chars</code></em>,
2597
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> substitutor</code></em>);</pre>
2598
- <p>
2599
- For each character in <em class="parameter"><code>string</code></em>, if the character is not in <em class="parameter"><code>valid_chars</code></em>,
2600
- replaces the character with <em class="parameter"><code>substitutor</code></em>. Modifies <em class="parameter"><code>string</code></em> in place,
2601
- and return <em class="parameter"><code>string</code></em> itself, not a copy. The return value is to allow
2602
- nesting such as <code class="literal">g_ascii_strup (g_strcanon (str, "abc", '?'))</code>.
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>string</code></em> :</span></p></td>
2609
- <td>a nul-terminated array of bytes.
2610
- </td>
2611
- </tr>
2612
- <tr>
2613
- <td><p><span class="term"><em class="parameter"><code>valid_chars</code></em> :</span></p></td>
2614
- <td>bytes permitted in <em class="parameter"><code>string</code></em>.
2615
- </td>
2616
- </tr>
2617
- <tr>
2618
- <td><p><span class="term"><em class="parameter"><code>substitutor</code></em> :</span></p></td>
2619
- <td>replacement character for disallowed bytes.
2620
- </td>
2621
- </tr>
2622
- <tr>
2623
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2624
- <td>
2625
- <em class="parameter"><code>string</code></em>.
2626
- </td>
2627
- </tr>
2628
- </tbody>
2629
- </table></div>
2630
- </div>
2631
- <hr>
2632
- <div class="refsect2">
2633
- <a name="g-strsplit"></a><h3>g_strsplit ()</h3>
2634
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> ** g_strsplit (<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>,
2635
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *delimiter</code></em>,
2636
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> max_tokens</code></em>);</pre>
2637
- <p>
2638
- Splits a string into a maximum of <em class="parameter"><code>max_tokens</code></em> pieces, using the given
2639
- <em class="parameter"><code>delimiter</code></em>. If <em class="parameter"><code>max_tokens</code></em> is reached, the remainder of <em class="parameter"><code>string</code></em> is appended
2640
- to the last token.
2641
- </p>
2642
- <p>
2643
- As a special case, the result of splitting the empty string "" is an empty
2644
- vector, not a vector containing a single string. The reason for this
2645
- special case is that being able to represent a empty vector is typically
2646
- more useful than consistent handling of empty elements. If you do need
2647
- to represent empty elements, you'll need to check for the empty string
2648
- before calling <a class="link" href="glib-String-Utility-Functions.html#g-strsplit" title="g_strsplit ()"><code class="function">g_strsplit()</code></a>.
2649
- </p>
2650
- <div class="variablelist"><table border="0">
2651
- <col align="left" valign="top">
2652
- <tbody>
2653
- <tr>
2654
- <td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
2655
- <td>a string to split.
2656
- </td>
2657
- </tr>
2658
- <tr>
2659
- <td><p><span class="term"><em class="parameter"><code>delimiter</code></em> :</span></p></td>
2660
- <td>a string which specifies the places at which to split the string.
2661
- The delimiter is not included in any of the resulting strings, unless
2662
- <em class="parameter"><code>max_tokens</code></em> is reached.
2663
- </td>
2664
- </tr>
2665
- <tr>
2666
- <td><p><span class="term"><em class="parameter"><code>max_tokens</code></em> :</span></p></td>
2667
- <td>the maximum number of pieces to split <em class="parameter"><code>string</code></em> into. If this is
2668
- less than 1, the string is split completely.
2669
- </td>
2670
- </tr>
2671
- <tr>
2672
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2673
- <td> a newly-allocated <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated array of strings. Use
2674
- <a class="link" href="glib-String-Utility-Functions.html#g-strfreev" title="g_strfreev ()"><code class="function">g_strfreev()</code></a> to free it.
2675
- </td>
2676
- </tr>
2677
- </tbody>
2678
- </table></div>
2679
- </div>
2680
- <hr>
2681
- <div class="refsect2">
2682
- <a name="g-strsplit-set"></a><h3>g_strsplit_set ()</h3>
2683
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> ** g_strsplit_set (<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>,
2684
- <em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *delimiters</code></em>,
2685
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> max_tokens</code></em>);</pre>
2686
- <p>
2687
- Splits <em class="parameter"><code>string</code></em> into a number of tokens not containing any of the characters
2688
- in <em class="parameter"><code>delimiter</code></em>. A token is the (possibly empty) longest string that does not
2689
- contain any of the characters in <em class="parameter"><code>delimiters</code></em>. If <em class="parameter"><code>max_tokens</code></em> is reached, the
2690
- remainder is appended to the last token.
2691
- </p>
2692
- <p>
2693
- For example the result of g_strsplit_set ("abc:def/ghi", ":/", -1) is a
2694
- <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated vector containing the three strings "abc", "def",
2695
- and "ghi".
2696
- </p>
2697
- <p>
2698
- The result if g_strsplit_set (":def/ghi:", ":/", -1) is a <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated
2699
- vector containing the four strings "", "def", "ghi", and "".
2700
- </p>
2701
- <p>
2702
- As a special case, the result of splitting the empty string "" is an empty
2703
- vector, not a vector containing a single string. The reason for this
2704
- special case is that being able to represent a empty vector is typically
2705
- more useful than consistent handling of empty elements. If you do need
2706
- to represent empty elements, you'll need to check for the empty string
2707
- before calling <a class="link" href="glib-String-Utility-Functions.html#g-strsplit-set" title="g_strsplit_set ()"><code class="function">g_strsplit_set()</code></a>.
2708
- </p>
2709
- <p>
2710
- Note that this function works on bytes not characters, so it can't be used
2711
- to delimit UTF-8 strings for anything but ASCII characters.
2712
- </p>
2713
- <div class="variablelist"><table border="0">
2714
- <col align="left" valign="top">
2715
- <tbody>
2716
- <tr>
2717
- <td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
2718
- <td>The string to be tokenized
2719
- </td>
2720
- </tr>
2721
- <tr>
2722
- <td><p><span class="term"><em class="parameter"><code>delimiters</code></em> :</span></p></td>
2723
- <td>A nul-terminated string containing bytes that are used
2724
- to split the string.
2725
- </td>
2726
- </tr>
2727
- <tr>
2728
- <td><p><span class="term"><em class="parameter"><code>max_tokens</code></em> :</span></p></td>
2729
- <td>The maximum number of tokens to split <em class="parameter"><code>string</code></em> into.
2730
- If this is less than 1, the string is split completely
2731
- </td>
2732
- </tr>
2733
- <tr>
2734
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2735
- <td> a newly-allocated <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated array of strings. Use
2736
- <a class="link" href="glib-String-Utility-Functions.html#g-strfreev" title="g_strfreev ()"><code class="function">g_strfreev()</code></a> to free it.
2737
-
2738
- </td>
2739
- </tr>
2740
- </tbody>
2741
- </table></div>
2742
- <p class="since">Since 2.4</p>
2743
- </div>
2744
- <hr>
2745
- <div class="refsect2">
2746
- <a name="g-strfreev"></a><h3>g_strfreev ()</h3>
2747
- <pre class="programlisting"><span class="returnvalue">void</span> g_strfreev (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **str_array</code></em>);</pre>
2748
- <p>
2749
- Frees a <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated array of strings, and the array itself.
2750
- If called on a <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> value, <a class="link" href="glib-String-Utility-Functions.html#g-strfreev" title="g_strfreev ()"><code class="function">g_strfreev()</code></a> simply returns.
2751
- </p>
2752
- <div class="variablelist"><table border="0">
2753
- <col align="left" valign="top">
2754
- <tbody><tr>
2755
- <td><p><span class="term"><em class="parameter"><code>str_array</code></em> :</span></p></td>
2756
- <td>a <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated array of strings to free.
2757
- </td>
2758
- </tr></tbody>
2759
- </table></div>
2760
- </div>
2761
- <hr>
2762
- <div class="refsect2">
2763
- <a name="g-strconcat"></a><h3>g_strconcat ()</h3>
2764
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_strconcat (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *string1</code></em>,
2765
- <em class="parameter"><code>...</code></em>);</pre>
2766
- <p>
2767
- Concatenates all of the given strings into one long string.
2768
- The returned string should be freed with <a class="link" href="glib-Memory-Allocation.html#g-free" title="g_free ()"><code class="function">g_free()</code></a> when no longer needed.
2769
- </p>
2770
- <p>
2771
- Note that this function is usually not the right function to use to
2772
- assemble a translated message from pieces, since proper translation
2773
- often requires the pieces to be reordered.
2774
- </p>
2775
- <p>
2776
- </p>
2777
- <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2778
- <h3 class="title">Warning</h3>
2779
- <p>The variable argument list <span class="emphasis"><em>must</em></span> end
2780
- with <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. If you forget the <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, <a class="link" href="glib-String-Utility-Functions.html#g-strconcat" title="g_strconcat ()"><code class="function">g_strconcat()</code></a> will start appending
2781
- random memory junk to your string.</p>
2782
- </div>
2783
- <p>
2784
- </p>
2785
- <div class="variablelist"><table border="0">
2786
- <col align="left" valign="top">
2787
- <tbody>
2788
- <tr>
2789
- <td><p><span class="term"><em class="parameter"><code>string1</code></em> :</span></p></td>
2790
- <td>the first string to add, which must not be <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
2791
- </td>
2792
- </tr>
2793
- <tr>
2794
- <td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
2795
- <td>a <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated list of strings to append to the string
2796
- </td>
2797
- </tr>
2798
- <tr>
2799
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2800
- <td> a newly-allocated string containing all the string arguments
2801
- </td>
2802
- </tr>
2803
- </tbody>
2804
- </table></div>
2805
- </div>
2806
- <hr>
2807
- <div class="refsect2">
2808
- <a name="g-strjoin"></a><h3>g_strjoin ()</h3>
2809
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_strjoin (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *separator</code></em>,
2810
- <em class="parameter"><code>...</code></em>);</pre>
2811
- <p>
2812
- Joins a number of strings together to form one long string, with the
2813
- optional <em class="parameter"><code>separator</code></em> inserted between each of them. The returned string
2814
- should be freed with <a class="link" href="glib-Memory-Allocation.html#g-free" title="g_free ()"><code class="function">g_free()</code></a>.
2815
- </p>
2816
- <div class="variablelist"><table border="0">
2817
- <col align="left" valign="top">
2818
- <tbody>
2819
- <tr>
2820
- <td><p><span class="term"><em class="parameter"><code>separator</code></em> :</span></p></td>
2821
- <td>a string to insert between each of the strings, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
2822
- </td>
2823
- </tr>
2824
- <tr>
2825
- <td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
2826
- <td>a <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated list of strings to join
2827
- </td>
2828
- </tr>
2829
- <tr>
2830
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2831
- <td> a newly-allocated string containing all of the strings joined
2832
- together, with <em class="parameter"><code>separator</code></em> between them
2833
- </td>
2834
- </tr>
2835
- </tbody>
2836
- </table></div>
2837
- </div>
2838
- <hr>
2839
- <div class="refsect2">
2840
- <a name="g-strjoinv"></a><h3>g_strjoinv ()</h3>
2841
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_strjoinv (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *separator</code></em>,
2842
- <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **str_array</code></em>);</pre>
2843
- <p>
2844
- Joins a number of strings together to form one long string, with the
2845
- optional <em class="parameter"><code>separator</code></em> inserted between each of them. The returned string
2846
- should be freed with <a class="link" href="glib-Memory-Allocation.html#g-free" title="g_free ()"><code class="function">g_free()</code></a>.
2847
- </p>
2848
- <div class="variablelist"><table border="0">
2849
- <col align="left" valign="top">
2850
- <tbody>
2851
- <tr>
2852
- <td><p><span class="term"><em class="parameter"><code>separator</code></em> :</span></p></td>
2853
- <td>a string to insert between each of the strings, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>
2854
- </td>
2855
- </tr>
2856
- <tr>
2857
- <td><p><span class="term"><em class="parameter"><code>str_array</code></em> :</span></p></td>
2858
- <td>a <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated array of strings to join
2859
- </td>
2860
- </tr>
2861
- <tr>
2862
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2863
- <td> a newly-allocated string containing all of the strings joined
2864
- together, with <em class="parameter"><code>separator</code></em> between them
2865
- </td>
2866
- </tr>
2867
- </tbody>
2868
- </table></div>
2869
- </div>
2870
- <hr>
2871
- <div class="refsect2">
2872
- <a name="g-strv-length"></a><h3>g_strv_length ()</h3>
2873
- <pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="returnvalue">guint</span></a> g_strv_length (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **str_array</code></em>);</pre>
2874
- <p>
2875
- Returns the length of the given <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated
2876
- string array <em class="parameter"><code>str_array</code></em>.
2877
- </p>
2878
- <div class="variablelist"><table border="0">
2879
- <col align="left" valign="top">
2880
- <tbody>
2881
- <tr>
2882
- <td><p><span class="term"><em class="parameter"><code>str_array</code></em> :</span></p></td>
2883
- <td>a <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated array of strings.
2884
- </td>
2885
- </tr>
2886
- <tr>
2887
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2888
- <td> length of <em class="parameter"><code>str_array</code></em>.
2889
-
2890
- </td>
2891
- </tr>
2892
- </tbody>
2893
- </table></div>
2894
- <p class="since">Since 2.6</p>
2895
- </div>
2896
- <hr>
2897
- <div class="refsect2">
2898
- <a name="g-strerror"></a><h3>g_strerror ()</h3>
2899
- <pre class="programlisting">const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_strerror (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> errnum</code></em>);</pre>
2900
- <p>
2901
- Returns a string corresponding to the given error code, e.g.
2902
- "no such process". You should use this function in preference to
2903
- <code class="function">strerror()</code>, because it returns a string in UTF-8 encoding, and since
2904
- not all platforms support the <code class="function">strerror()</code> function.
2905
- </p>
2906
- <div class="variablelist"><table border="0">
2907
- <col align="left" valign="top">
2908
- <tbody>
2909
- <tr>
2910
- <td><p><span class="term"><em class="parameter"><code>errnum</code></em> :</span></p></td>
2911
- <td>the system error number. See the standard C <code class="literal">errno</code>
2912
- documentation
2913
- </td>
2914
- </tr>
2915
- <tr>
2916
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2917
- <td> a UTF-8 string describing the error code. If the error code
2918
- is unknown, it returns "unknown error (&lt;code&gt;)". The string
2919
- can only be used until the next call to <a class="link" href="glib-String-Utility-Functions.html#g-strerror" title="g_strerror ()"><code class="function">g_strerror()</code></a>
2920
- </td>
2921
- </tr>
2922
- </tbody>
2923
- </table></div>
2924
- </div>
2925
- <hr>
2926
- <div class="refsect2">
2927
- <a name="g-strsignal"></a><h3>g_strsignal ()</h3>
2928
- <pre class="programlisting">const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_strsignal (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> signum</code></em>);</pre>
2929
- <p>
2930
- Returns a string describing the given signal, e.g. "Segmentation fault".
2931
- You should use this function in preference to <code class="function">strsignal()</code>, because it
2932
- returns a string in UTF-8 encoding, and since not all platforms support
2933
- the <code class="function">strsignal()</code> function.
2934
- </p>
2935
- <div class="variablelist"><table border="0">
2936
- <col align="left" valign="top">
2937
- <tbody>
2938
- <tr>
2939
- <td><p><span class="term"><em class="parameter"><code>signum</code></em> :</span></p></td>
2940
- <td>the signal number. See the <code class="literal">signal</code>
2941
- documentation
2942
- </td>
2943
- </tr>
2944
- <tr>
2945
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2946
- <td> a UTF-8 string describing the signal. If the signal is unknown,
2947
- it returns "unknown signal (&lt;signum&gt;)". The string can only be
2948
- used until the next call to <a class="link" href="glib-String-Utility-Functions.html#g-strsignal" title="g_strsignal ()"><code class="function">g_strsignal()</code></a>
2949
- </td>
2950
- </tr>
2951
- </tbody>
2952
- </table></div>
2953
- </div>
2954
- </div>
2955
- </div>
2956
- <div class="footer">
2957
- <hr>
2958
- Generated by GTK-Doc V1.15.1</div>
2959
- </body>
2960
- </html>