← Back to branch summary

~ubuntu-branches/ubuntu/trusty/glib2.0/trusty-proposed

« back to all changes in this revision

Viewing changes to docs/reference/glib/html/glib-String-Utility-Functions.html

Tags: upstream-2.15.6
Import upstream version 2.15.6

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/glib/html/glib-String-Utility-Functions.html
36
36
<th width="100%" align="center">GLib Reference Manual</th>
37
37
<td><a accesskey="n" href="glib-Character-Set-Conversion.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
38
38
</tr>
39
 
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2827934" class="shortcut">Top</a>
 
39
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2840985" class="shortcut">Top</a>
40
40
                  &#160;|&#160;
41
 
                  <a href="#id2830066" class="shortcut">Description</a></nobr></td></tr>
 
41
                  <a href="#id2843117" class="shortcut">Description</a></nobr></td></tr>
42
42
</table>
43
43
<div class="refentry" lang="en">
44
44
<a name="glib-String-Utility-Functions"></a><div class="titlepage"></div>
45
45
<div class="refnamediv"><table width="100%"><tr>
46
46
<td valign="top">
47
47
<h2>
48
 
<a name="id2827934"></a><span class="refentrytitle">String Utility Functions</span>
 
48
<a name="id2840985"></a><span class="refentrytitle">String Utility Functions</span>
49
49
</h2>
50
50
<p>String Utility Functions &#8212; various string-related functions</p>
51
51
</td>
218
218
</pre>
219
219
</div>
220
220
<div class="refsect1" lang="en">
221
 
<a name="id2830066"></a><h2>Description</h2>
 
221
<a name="id2843117"></a><h2>Description</h2>
222
222
<p>
223
223
This section describes a number of utility functions for creating,
224
224
duplicating, and manipulating strings.
247
247
</p>
248
248
</div>
249
249
<div class="refsect1" lang="en">
250
 
<a name="id2830295"></a><h2>Details</h2>
 
250
<a name="id2843345"></a><h2>Details</h2>
251
251
<div class="refsect2" lang="en">
252
 
<a name="id2830305"></a><h3>
 
252
<a name="id2843355"></a><h3>
253
253
<a name="g-strdup"></a>g_strdup ()</h3>
254
 
<a class="indexterm" name="id2830318"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_strdup                            (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *str);</pre>
 
254
<a class="indexterm" name="id2843368"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_strdup                            (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *str);</pre>
255
255
<p>
256
256
Duplicates a string.
257
257
If <em class="parameter"><code>str</code></em> is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> it returns <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
277
277
</div>
278
278
<hr>
279
279
<div class="refsect2" lang="en">
280
 
<a name="id2830408"></a><h3>
 
280
<a name="id2843459"></a><h3>
281
281
<a name="g-strndup"></a>g_strndup ()</h3>
282
 
<a class="indexterm" name="id2830421"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_strndup                           (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *str,
 
282
<a class="indexterm" name="id2843471"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_strndup                           (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *str,
283
283
                                                         <a class="link" href="glib-Basic-Types.html#gsize">gsize</a> n);</pre>
284
284
<p>
285
285
Duplicates the first <em class="parameter"><code>n</code></em> bytes of a string, returning a newly-allocated
324
324
</div>
325
325
<hr>
326
326
<div class="refsect2" lang="en">
327
 
<a name="id2830594"></a><h3>
 
327
<a name="id2843644"></a><h3>
328
328
<a name="g-strdupv"></a>g_strdupv ()</h3>
329
 
<a class="indexterm" name="id2830606"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>**             g_strdupv                           (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> **str_array);</pre>
 
329
<a class="indexterm" name="id2843657"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>**             g_strdupv                           (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> **str_array);</pre>
330
330
<p>
331
331
Copies <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of strings. The copy is a deep copy;
332
332
the new array should be freed by first freeing each string, then
352
352
</div>
353
353
<hr>
354
354
<div class="refsect2" lang="en">
355
 
<a name="id2830742"></a><h3>
 
355
<a name="id2843792"></a><h3>
356
356
<a name="g-strnfill"></a>g_strnfill ()</h3>
357
 
<a class="indexterm" name="id2830754"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_strnfill                          (<a class="link" href="glib-Basic-Types.html#gsize">gsize</a> length,
 
357
<a class="indexterm" name="id2843805"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_strnfill                          (<a class="link" href="glib-Basic-Types.html#gsize">gsize</a> length,
358
358
                                                         <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> fill_char);</pre>
359
359
<p>
360
360
Creates a new string <em class="parameter"><code>length</code></em> bytes long filled with <em class="parameter"><code>fill_char</code></em>.
385
385
</div>
386
386
<hr>
387
387
<div class="refsect2" lang="en">
388
 
<a name="id2830857"></a><h3>
 
388
<a name="id2843907"></a><h3>
389
389
<a name="g-stpcpy"></a>g_stpcpy ()</h3>
390
 
<a class="indexterm" name="id2830869"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_stpcpy                            (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *dest,
 
390
<a class="indexterm" name="id2843920"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_stpcpy                            (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *dest,
391
391
                                                         const char *src);</pre>
392
392
<p>
393
393
Copies a nul-terminated string into the dest buffer, include the
420
420
</div>
421
421
<hr>
422
422
<div class="refsect2" lang="en">
423
 
<a name="id2830955"></a><h3>
 
423
<a name="id2844006"></a><h3>
424
424
<a name="g-strstr-len"></a>g_strstr_len ()</h3>
425
 
<a class="indexterm" name="id2830968"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_strstr_len                        (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *haystack,
 
425
<a class="indexterm" name="id2844019"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_strstr_len                        (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *haystack,
426
426
                                                         <a class="link" href="glib-Basic-Types.html#gssize">gssize</a> haystack_len,
427
427
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *needle);</pre>
428
428
<p>
461
461
</div>
462
462
<hr>
463
463
<div class="refsect2" lang="en">
464
 
<a name="id2831109"></a><h3>
 
464
<a name="id2844159"></a><h3>
465
465
<a name="g-strrstr"></a>g_strrstr ()</h3>
466
 
<a class="indexterm" name="id2831121"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_strrstr                           (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *haystack,
 
466
<a class="indexterm" name="id2844172"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_strrstr                           (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *haystack,
467
467
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *needle);</pre>
468
468
<p>
469
469
Searches the string <em class="parameter"><code>haystack</code></em> for the last occurrence
495
495
</div>
496
496
<hr>
497
497
<div class="refsect2" lang="en">
498
 
<a name="id2831228"></a><h3>
 
498
<a name="id2844278"></a><h3>
499
499
<a name="g-strrstr-len"></a>g_strrstr_len ()</h3>
500
 
<a class="indexterm" name="id2831240"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_strrstr_len                       (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *haystack,
 
500
<a class="indexterm" name="id2844290"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_strrstr_len                       (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *haystack,
501
501
                                                         <a class="link" href="glib-Basic-Types.html#gssize">gssize</a> haystack_len,
502
502
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *needle);</pre>
503
503
<p>
536
536
</div>
537
537
<hr>
538
538
<div class="refsect2" lang="en">
539
 
<a name="id2831381"></a><h3>
 
539
<a name="id2844431"></a><h3>
540
540
<a name="g-str-has-prefix"></a>g_str_has_prefix ()</h3>
541
 
<a class="indexterm" name="id2831396"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_str_has_prefix                    (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *str,
 
541
<a class="indexterm" name="id2844446"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_str_has_prefix                    (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *str,
542
542
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *prefix);</pre>
543
543
<p>
544
544
Looks whether the string <em class="parameter"><code>str</code></em> begins with <em class="parameter"><code>prefix</code></em>.</p>
571
571
</div>
572
572
<hr>
573
573
<div class="refsect2" lang="en">
574
 
<a name="id2831529"></a><h3>
 
574
<a name="id2844579"></a><h3>
575
575
<a name="g-str-has-suffix"></a>g_str_has_suffix ()</h3>
576
 
<a class="indexterm" name="id2831544"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_str_has_suffix                    (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *str,
 
576
<a class="indexterm" name="id2844595"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_str_has_suffix                    (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *str,
577
577
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *suffix);</pre>
578
578
<p>
579
579
Looks whether the string <em class="parameter"><code>str</code></em> ends with <em class="parameter"><code>suffix</code></em>.</p>
606
606
</div>
607
607
<hr>
608
608
<div class="refsect2" lang="en">
609
 
<a name="id2831677"></a><h3>
 
609
<a name="id2844727"></a><h3>
610
610
<a name="g-strlcpy"></a>g_strlcpy ()</h3>
611
 
<a class="indexterm" name="id2831690"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gsize">gsize</a>               g_strlcpy                           (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *dest,
 
611
<a class="indexterm" name="id2844740"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gsize">gsize</a>               g_strlcpy                           (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *dest,
612
612
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *src,
613
613
                                                         <a class="link" href="glib-Basic-Types.html#gsize">gsize</a> dest_size);</pre>
614
614
<p>
649
649
</div>
650
650
<hr>
651
651
<div class="refsect2" lang="en">
652
 
<a name="id2831901"></a><h3>
 
652
<a name="id2844951"></a><h3>
653
653
<a name="g-strlcat"></a>g_strlcat ()</h3>
654
 
<a class="indexterm" name="id2831914"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gsize">gsize</a>               g_strlcat                           (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *dest,
 
654
<a class="indexterm" name="id2844964"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gsize">gsize</a>               g_strlcat                           (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *dest,
655
655
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *src,
656
656
                                                         <a class="link" href="glib-Basic-Types.html#gsize">gsize</a> dest_size);</pre>
657
657
<p>
691
691
</div>
692
692
<hr>
693
693
<div class="refsect2" lang="en">
694
 
<a name="id2832118"></a><h3>
 
694
<a name="id2845169"></a><h3>
695
695
<a name="g-strdup-printf"></a>g_strdup_printf ()</h3>
696
 
<a class="indexterm" name="id2832131"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_strdup_printf                     (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *format,
 
696
<a class="indexterm" name="id2845182"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_strdup_printf                     (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *format,
697
697
                                                         ...);</pre>
698
698
<p>
699
699
Similar to the standard C <code class="function">sprintf()</code> function
727
727
</div>
728
728
<hr>
729
729
<div class="refsect2" lang="en">
730
 
<a name="id2832238"></a><h3>
 
730
<a name="id2845288"></a><h3>
731
731
<a name="g-strdup-vprintf"></a>g_strdup_vprintf ()</h3>
732
 
<a class="indexterm" name="id2832250"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_strdup_vprintf                    (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *format,
 
732
<a class="indexterm" name="id2845300"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_strdup_vprintf                    (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *format,
733
733
                                                         va_list args);</pre>
734
734
<p>
735
735
Similar to the standard C <code class="function">vsprintf()</code> function
767
767
</div>
768
768
<hr>
769
769
<div class="refsect2" lang="en">
770
 
<a name="id2832379"></a><h3>
 
770
<a name="id2845429"></a><h3>
771
771
<a name="g-printf"></a>g_printf ()</h3>
772
 
<a class="indexterm" name="id2832394"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint">gint</a>                g_printf                            (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> const *format,
 
772
<a class="indexterm" name="id2845444"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint">gint</a>                g_printf                            (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> const *format,
773
773
                                                         ...);</pre>
774
774
<p>
775
775
An implementation of the standard <code class="function">printf()</code> function which supports 
804
804
</div>
805
805
<hr>
806
806
<div class="refsect2" lang="en">
807
 
<a name="id2832506"></a><h3>
 
807
<a name="id2845556"></a><h3>
808
808
<a name="g-vprintf"></a>g_vprintf ()</h3>
809
 
<a class="indexterm" name="id2832521"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint">gint</a>                g_vprintf                           (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> const *format,
 
809
<a class="indexterm" name="id2845571"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint">gint</a>                g_vprintf                           (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> const *format,
810
810
                                                         va_list args);</pre>
811
811
<p>
812
812
An implementation of the standard <code class="function">vprintf()</code> function which supports 
841
841
</div>
842
842
<hr>
843
843
<div class="refsect2" lang="en">
844
 
<a name="id2832642"></a><h3>
 
844
<a name="id2845693"></a><h3>
845
845
<a name="g-fprintf"></a>g_fprintf ()</h3>
846
 
<a class="indexterm" name="id2832657"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint">gint</a>                g_fprintf                           (FILE *file,
 
846
<a class="indexterm" name="id2845707"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint">gint</a>                g_fprintf                           (FILE *file,
847
847
                                                         <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> const *format,
848
848
                                                         ...);</pre>
849
849
<p>
884
884
</div>
885
885
<hr>
886
886
<div class="refsect2" lang="en">
887
 
<a name="id2832793"></a><h3>
 
887
<a name="id2845844"></a><h3>
888
888
<a name="g-vfprintf"></a>g_vfprintf ()</h3>
889
 
<a class="indexterm" name="id2832808"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint">gint</a>                g_vfprintf                          (FILE *file,
 
889
<a class="indexterm" name="id2845858"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint">gint</a>                g_vfprintf                          (FILE *file,
890
890
                                                         <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> const *format,
891
891
                                                         va_list args);</pre>
892
892
<p>
927
927
</div>
928
928
<hr>
929
929
<div class="refsect2" lang="en">
930
 
<a name="id2832950"></a><h3>
 
930
<a name="id2846000"></a><h3>
931
931
<a name="g-sprintf"></a>g_sprintf ()</h3>
932
 
<a class="indexterm" name="id2832965"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint">gint</a>                g_sprintf                           (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string,
 
932
<a class="indexterm" name="id2846015"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint">gint</a>                g_sprintf                           (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string,
933
933
                                                         <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> const *format,
934
934
                                                         ...);</pre>
935
935
<p>
972
972
</div>
973
973
<hr>
974
974
<div class="refsect2" lang="en">
975
 
<a name="id2833102"></a><h3>
 
975
<a name="id2846153"></a><h3>
976
976
<a name="g-vsprintf"></a>g_vsprintf ()</h3>
977
 
<a class="indexterm" name="id2833116"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint">gint</a>                g_vsprintf                          (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string,
 
977
<a class="indexterm" name="id2846167"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint">gint</a>                g_vsprintf                          (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string,
978
978
                                                         <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> const *format,
979
979
                                                         va_list args);</pre>
980
980
<p>
1015
1015
</div>
1016
1016
<hr>
1017
1017
<div class="refsect2" lang="en">
1018
 
<a name="id2833258"></a><h3>
 
1018
<a name="id2846309"></a><h3>
1019
1019
<a name="g-snprintf"></a>g_snprintf ()</h3>
1020
 
<a class="indexterm" name="id2833271"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint">gint</a>                g_snprintf                          (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string,
 
1020
<a class="indexterm" name="id2846321"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint">gint</a>                g_snprintf                          (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string,
1021
1021
                                                         <a class="link" href="glib-Basic-Types.html#gulong">gulong</a> n,
1022
1022
                                                         <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> const *format,
1023
1023
                                                         ...);</pre>
1081
1081
</div>
1082
1082
<hr>
1083
1083
<div class="refsect2" lang="en">
1084
 
<a name="id2833494"></a><h3>
 
1084
<a name="id2846544"></a><h3>
1085
1085
<a name="g-vsnprintf"></a>g_vsnprintf ()</h3>
1086
 
<a class="indexterm" name="id2833506"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint">gint</a>                g_vsnprintf                         (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string,
 
1086
<a class="indexterm" name="id2846556"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint">gint</a>                g_vsnprintf                         (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string,
1087
1087
                                                         <a class="link" href="glib-Basic-Types.html#gulong">gulong</a> n,
1088
1088
                                                         <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> const *format,
1089
1089
                                                         va_list args);</pre>
1147
1147
</div>
1148
1148
<hr>
1149
1149
<div class="refsect2" lang="en">
1150
 
<a name="id2833736"></a><h3>
 
1150
<a name="id2846787"></a><h3>
1151
1151
<a name="g-vasprintf"></a>g_vasprintf ()</h3>
1152
 
<a class="indexterm" name="id2833751"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint">gint</a>                g_vasprintf                         (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> **string,
 
1152
<a class="indexterm" name="id2846801"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint">gint</a>                g_vasprintf                         (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> **string,
1153
1153
                                                         <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> const *format,
1154
1154
                                                         va_list args);</pre>
1155
1155
<p>
1193
1193
</div>
1194
1194
<hr>
1195
1195
<div class="refsect2" lang="en">
1196
 
<a name="id2833908"></a><h3>
 
1196
<a name="id2846958"></a><h3>
1197
1197
<a name="g-printf-string-upper-bound"></a>g_printf_string_upper_bound ()</h3>
1198
 
<a class="indexterm" name="id2833922"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gsize">gsize</a>               g_printf_string_upper_bound         (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *format,
 
1198
<a class="indexterm" name="id2846972"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gsize">gsize</a>               g_printf_string_upper_bound         (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *format,
1199
1199
                                                         va_list args);</pre>
1200
1200
<p>
1201
1201
Calculates the maximum space needed to store the output of the <code class="function">sprintf()</code> 
1226
1226
</div>
1227
1227
<hr>
1228
1228
<div class="refsect2" lang="en">
1229
 
<a name="id2834024"></a><h3>
 
1229
<a name="id2847074"></a><h3>
1230
1230
<a name="g-ascii-isalnum"></a>g_ascii_isalnum ()</h3>
1231
 
<a class="indexterm" name="id2834036"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_ascii_isalnum                     (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> c);</pre>
 
1231
<a class="indexterm" name="id2847087"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_ascii_isalnum                     (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> c);</pre>
1232
1232
<p>
1233
1233
Determines whether a character is alphanumeric.
1234
1234
</p>
1261
1261
</div>
1262
1262
<hr>
1263
1263
<div class="refsect2" lang="en">
1264
 
<a name="id2834166"></a><h3>
 
1264
<a name="id2847216"></a><h3>
1265
1265
<a name="g-ascii-isalpha"></a>g_ascii_isalpha ()</h3>
1266
 
<a class="indexterm" name="id2834179"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_ascii_isalpha                     (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> c);</pre>
 
1266
<a class="indexterm" name="id2847229"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_ascii_isalpha                     (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> c);</pre>
1267
1267
<p>
1268
1268
Determines whether a character is alphabetic (i.e. a letter).
1269
1269
</p>
1296
1296
</div>
1297
1297
<hr>
1298
1298
<div class="refsect2" lang="en">
1299
 
<a name="id2834306"></a><h3>
 
1299
<a name="id2847357"></a><h3>
1300
1300
<a name="g-ascii-iscntrl"></a>g_ascii_iscntrl ()</h3>
1301
 
<a class="indexterm" name="id2834319"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_ascii_iscntrl                     (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> c);</pre>
 
1301
<a class="indexterm" name="id2847370"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_ascii_iscntrl                     (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> c);</pre>
1302
1302
<p>
1303
1303
Determines whether a character is a control character.
1304
1304
</p>
1331
1331
</div>
1332
1332
<hr>
1333
1333
<div class="refsect2" lang="en">
1334
 
<a name="id2834447"></a><h3>
 
1334
<a name="id2847498"></a><h3>
1335
1335
<a name="g-ascii-isdigit"></a>g_ascii_isdigit ()</h3>
1336
 
<a class="indexterm" name="id2834460"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_ascii_isdigit                     (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> c);</pre>
 
1336
<a class="indexterm" name="id2847510"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_ascii_isdigit                     (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> c);</pre>
1337
1337
<p>
1338
1338
Determines whether a character is digit (0-9).
1339
1339
</p>
1364
1364
</div>
1365
1365
<hr>
1366
1366
<div class="refsect2" lang="en">
1367
 
<a name="id2834575"></a><h3>
 
1367
<a name="id2847625"></a><h3>
1368
1368
<a name="g-ascii-isgraph"></a>g_ascii_isgraph ()</h3>
1369
 
<a class="indexterm" name="id2834588"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_ascii_isgraph                     (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> c);</pre>
 
1369
<a class="indexterm" name="id2847638"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_ascii_isgraph                     (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> c);</pre>
1370
1370
<p>
1371
1371
Determines whether a character is a printing character and not a space.
1372
1372
</p>
1399
1399
</div>
1400
1400
<hr>
1401
1401
<div class="refsect2" lang="en">
1402
 
<a name="id2834716"></a><h3>
 
1402
<a name="id2847767"></a><h3>
1403
1403
<a name="g-ascii-islower"></a>g_ascii_islower ()</h3>
1404
 
<a class="indexterm" name="id2834729"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_ascii_islower                     (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> c);</pre>
 
1404
<a class="indexterm" name="id2847780"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_ascii_islower                     (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> c);</pre>
1405
1405
<p>
1406
1406
Determines whether a character is an ASCII lower case letter.
1407
1407
</p>
1434
1434
</div>
1435
1435
<hr>
1436
1436
<div class="refsect2" lang="en">
1437
 
<a name="id2834857"></a><h3>
 
1437
<a name="id2847907"></a><h3>
1438
1438
<a name="g-ascii-isprint"></a>g_ascii_isprint ()</h3>
1439
 
<a class="indexterm" name="id2834870"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_ascii_isprint                     (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> c);</pre>
 
1439
<a class="indexterm" name="id2847920"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_ascii_isprint                     (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> c);</pre>
1440
1440
<p>
1441
1441
Determines whether a character is a printing character.
1442
1442
</p>
1469
1469
</div>
1470
1470
<hr>
1471
1471
<div class="refsect2" lang="en">
1472
 
<a name="id2834998"></a><h3>
 
1472
<a name="id2848048"></a><h3>
1473
1473
<a name="g-ascii-ispunct"></a>g_ascii_ispunct ()</h3>
1474
 
<a class="indexterm" name="id2835011"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_ascii_ispunct                     (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> c);</pre>
 
1474
<a class="indexterm" name="id2848061"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_ascii_ispunct                     (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> c);</pre>
1475
1475
<p>
1476
1476
Determines whether a character is a punctuation character.
1477
1477
</p>
1504
1504
</div>
1505
1505
<hr>
1506
1506
<div class="refsect2" lang="en">
1507
 
<a name="id2835139"></a><h3>
 
1507
<a name="id2848189"></a><h3>
1508
1508
<a name="g-ascii-isspace"></a>g_ascii_isspace ()</h3>
1509
 
<a class="indexterm" name="id2835152"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_ascii_isspace                     (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> c);</pre>
 
1509
<a class="indexterm" name="id2848202"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_ascii_isspace                     (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> c);</pre>
1510
1510
<p>
1511
1511
Determines whether a character is a white-space character.
1512
1512
</p>
1539
1539
</div>
1540
1540
<hr>
1541
1541
<div class="refsect2" lang="en">
1542
 
<a name="id2835280"></a><h3>
 
1542
<a name="id2848330"></a><h3>
1543
1543
<a name="g-ascii-isupper"></a>g_ascii_isupper ()</h3>
1544
 
<a class="indexterm" name="id2835293"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_ascii_isupper                     (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> c);</pre>
 
1544
<a class="indexterm" name="id2848343"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_ascii_isupper                     (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> c);</pre>
1545
1545
<p>
1546
1546
Determines whether a character is an ASCII upper case letter.
1547
1547
</p>
1574
1574
</div>
1575
1575
<hr>
1576
1576
<div class="refsect2" lang="en">
1577
 
<a name="id2835420"></a><h3>
 
1577
<a name="id2848471"></a><h3>
1578
1578
<a name="g-ascii-isxdigit"></a>g_ascii_isxdigit ()</h3>
1579
 
<a class="indexterm" name="id2835433"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_ascii_isxdigit                    (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> c);</pre>
 
1579
<a class="indexterm" name="id2848484"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_ascii_isxdigit                    (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> c);</pre>
1580
1580
<p>
1581
1581
Determines whether a character is a hexadecimal-digit character.
1582
1582
</p>
1607
1607
</div>
1608
1608
<hr>
1609
1609
<div class="refsect2" lang="en">
1610
 
<a name="id2835549"></a><h3>
 
1610
<a name="id2848599"></a><h3>
1611
1611
<a name="g-ascii-digit-value"></a>g_ascii_digit_value ()</h3>
1612
 
<a class="indexterm" name="id2835562"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint">gint</a>                g_ascii_digit_value                 (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> c);</pre>
 
1612
<a class="indexterm" name="id2848612"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint">gint</a>                g_ascii_digit_value                 (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> c);</pre>
1613
1613
<p>
1614
1614
Determines the numeric value of a character as a decimal
1615
1615
digit. Differs from <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-digit-value"><code class="function">g_unichar_digit_value()</code></a> because it takes
1637
1637
</div>
1638
1638
<hr>
1639
1639
<div class="refsect2" lang="en">
1640
 
<a name="id2835654"></a><h3>
 
1640
<a name="id2848705"></a><h3>
1641
1641
<a name="g-ascii-xdigit-value"></a>g_ascii_xdigit_value ()</h3>
1642
 
<a class="indexterm" name="id2835668"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint">gint</a>                g_ascii_xdigit_value                (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> c);</pre>
 
1642
<a class="indexterm" name="id2848718"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint">gint</a>                g_ascii_xdigit_value                (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> c);</pre>
1643
1643
<p>
1644
1644
Determines the numeric value of a character as a hexidecimal
1645
1645
digit. Differs from <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-xdigit-value"><code class="function">g_unichar_xdigit_value()</code></a> because it takes
1667
1667
</div>
1668
1668
<hr>
1669
1669
<div class="refsect2" lang="en">
1670
 
<a name="id2835761"></a><h3>
 
1670
<a name="id2848811"></a><h3>
1671
1671
<a name="g-ascii-strcasecmp"></a>g_ascii_strcasecmp ()</h3>
1672
 
<a class="indexterm" name="id2835774"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint">gint</a>                g_ascii_strcasecmp                  (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *s1,
 
1672
<a class="indexterm" name="id2848825"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint">gint</a>                g_ascii_strcasecmp                  (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *s1,
1673
1673
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *s2);</pre>
1674
1674
<p>
1675
1675
Compare two strings, ignoring the case of ASCII characters.
1714
1714
</div>
1715
1715
<hr>
1716
1716
<div class="refsect2" lang="en">
1717
 
<a name="id2835920"></a><h3>
 
1717
<a name="id2848971"></a><h3>
1718
1718
<a name="g-ascii-strncasecmp"></a>g_ascii_strncasecmp ()</h3>
1719
 
<a class="indexterm" name="id2835934"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint">gint</a>                g_ascii_strncasecmp                 (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *s1,
 
1719
<a class="indexterm" name="id2848984"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint">gint</a>                g_ascii_strncasecmp                 (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *s1,
1720
1720
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *s2,
1721
1721
                                                         <a class="link" href="glib-Basic-Types.html#gsize">gsize</a> n);</pre>
1722
1722
<p>
1764
1764
</div>
1765
1765
<hr>
1766
1766
<div class="refsect2" lang="en">
1767
 
<a name="id2836124"></a><h3>
 
1767
<a name="id2849174"></a><h3>
1768
1768
<a name="g-ascii-strup"></a>g_ascii_strup ()</h3>
1769
 
<a class="indexterm" name="id2836136"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_ascii_strup                       (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *str,
 
1769
<a class="indexterm" name="id2849187"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_ascii_strup                       (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *str,
1770
1770
                                                         <a class="link" href="glib-Basic-Types.html#gssize">gssize</a> len);</pre>
1771
1771
<p>
1772
1772
Converts all lower case ASCII letters to upper case ASCII letters.</p>
1800
1800
</div>
1801
1801
<hr>
1802
1802
<div class="refsect2" lang="en">
1803
 
<a name="id2836261"></a><h3>
 
1803
<a name="id2849311"></a><h3>
1804
1804
<a name="g-ascii-strdown"></a>g_ascii_strdown ()</h3>
1805
 
<a class="indexterm" name="id2836274"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_ascii_strdown                     (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *str,
 
1805
<a class="indexterm" name="id2849324"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_ascii_strdown                     (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *str,
1806
1806
                                                         <a class="link" href="glib-Basic-Types.html#gssize">gssize</a> len);</pre>
1807
1807
<p>
1808
1808
Converts all upper case ASCII letters to lower case ASCII letters.</p>
1836
1836
</div>
1837
1837
<hr>
1838
1838
<div class="refsect2" lang="en">
1839
 
<a name="id2836399"></a><h3>
 
1839
<a name="id2849449"></a><h3>
1840
1840
<a name="g-ascii-tolower"></a>g_ascii_tolower ()</h3>
1841
 
<a class="indexterm" name="id2836412"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>               g_ascii_tolower                     (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> c);</pre>
 
1841
<a class="indexterm" name="id2849462"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>               g_ascii_tolower                     (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> c);</pre>
1842
1842
<p>
1843
1843
Convert a character to ASCII lower case.
1844
1844
</p>
1873
1873
</div>
1874
1874
<hr>
1875
1875
<div class="refsect2" lang="en">
1876
 
<a name="id2836531"></a><h3>
 
1876
<a name="id2849581"></a><h3>
1877
1877
<a name="g-ascii-toupper"></a>g_ascii_toupper ()</h3>
1878
 
<a class="indexterm" name="id2836544"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>               g_ascii_toupper                     (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> c);</pre>
 
1878
<a class="indexterm" name="id2849594"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>               g_ascii_toupper                     (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> c);</pre>
1879
1879
<p>
1880
1880
Convert a character to ASCII upper case.
1881
1881
</p>
1910
1910
</div>
1911
1911
<hr>
1912
1912
<div class="refsect2" lang="en">
1913
 
<a name="id2836662"></a><h3>
 
1913
<a name="id2849713"></a><h3>
1914
1914
<a name="g-string-ascii-up"></a>g_string_ascii_up ()</h3>
1915
 
<a class="indexterm" name="id2836676"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_ascii_up                   (<a class="link" href="glib-Strings.html#GString">GString</a> *string);</pre>
 
1915
<a class="indexterm" name="id2849726"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_ascii_up                   (<a class="link" href="glib-Strings.html#GString">GString</a> *string);</pre>
1916
1916
<p>
1917
1917
Converts all lower case ASCII letters to upper case ASCII letters.</p>
1918
1918
<p>
1938
1938
</div>
1939
1939
<hr>
1940
1940
<div class="refsect2" lang="en">
1941
 
<a name="id2836755"></a><h3>
 
1941
<a name="id2849805"></a><h3>
1942
1942
<a name="g-string-ascii-down"></a>g_string_ascii_down ()</h3>
1943
 
<a class="indexterm" name="id2836768"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_ascii_down                 (<a class="link" href="glib-Strings.html#GString">GString</a> *string);</pre>
 
1943
<a class="indexterm" name="id2849819"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_ascii_down                 (<a class="link" href="glib-Strings.html#GString">GString</a> *string);</pre>
1944
1944
<p>
1945
1945
Converts all upper case ASCII letters to lower case ASCII letters.</p>
1946
1946
<p>
1966
1966
</div>
1967
1967
<hr>
1968
1968
<div class="refsect2" lang="en">
1969
 
<a name="id2836848"></a><h3>
 
1969
<a name="id2849898"></a><h3>
1970
1970
<a name="g-strup"></a>g_strup ()</h3>
1971
 
<a class="indexterm" name="id2836863"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_strup                             (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string);</pre>
 
1971
<a class="indexterm" name="id2849913"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_strup                             (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string);</pre>
1972
1972
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1973
1973
<h3 class="title">Warning</h3>
1974
1974
<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 
1997
1997
</div>
1998
1998
<hr>
1999
1999
<div class="refsect2" lang="en">
2000
 
<a name="id2836971"></a><h3>
 
2000
<a name="id2850021"></a><h3>
2001
2001
<a name="g-strdown"></a>g_strdown ()</h3>
2002
 
<a class="indexterm" name="id2836986"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_strdown                           (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string);</pre>
 
2002
<a class="indexterm" name="id2850036"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_strdown                           (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string);</pre>
2003
2003
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2004
2004
<h3 class="title">Warning</h3>
2005
2005
<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 
2029
2029
</div>
2030
2030
<hr>
2031
2031
<div class="refsect2" lang="en">
2032
 
<a name="id2837094"></a><h3>
 
2032
<a name="id2850145"></a><h3>
2033
2033
<a name="g-strcasecmp"></a>g_strcasecmp ()</h3>
2034
 
<a class="indexterm" name="id2837110"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint">gint</a>                g_strcasecmp                        (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *s1,
 
2034
<a class="indexterm" name="id2850160"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint">gint</a>                g_strcasecmp                        (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *s1,
2035
2035
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *s2);</pre>
2036
2036
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2037
2037
<h3 class="title">Warning</h3>
2068
2068
</div>
2069
2069
<hr>
2070
2070
<div class="refsect2" lang="en">
2071
 
<a name="id2837257"></a><h3>
 
2071
<a name="id2850308"></a><h3>
2072
2072
<a name="g-strncasecmp"></a>g_strncasecmp ()</h3>
2073
 
<a class="indexterm" name="id2837273"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint">gint</a>                g_strncasecmp                       (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *s1,
 
2073
<a class="indexterm" name="id2850323"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint">gint</a>                g_strncasecmp                       (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *s1,
2074
2074
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *s2,
2075
2075
                                                         <a class="link" href="glib-Basic-Types.html#guint">guint</a> n);</pre>
2076
2076
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
2127
2127
</div>
2128
2128
<hr>
2129
2129
<div class="refsect2" lang="en">
2130
 
<a name="id2837527"></a><h3>
 
2130
<a name="id2850578"></a><h3>
2131
2131
<a name="g-strreverse"></a>g_strreverse ()</h3>
2132
 
<a class="indexterm" name="id2837540"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_strreverse                        (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string);</pre>
 
2132
<a class="indexterm" name="id2850591"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_strreverse                        (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string);</pre>
2133
2133
<p>
2134
2134
Reverses all of the bytes in a string.
2135
2135
For example, <code class="literal">g_strreverse ("abcdef")</code> will result in "fedcba".
2158
2158
</div>
2159
2159
<hr>
2160
2160
<div class="refsect2" lang="en">
2161
 
<a name="id2837639"></a><h3>
 
2161
<a name="id2850689"></a><h3>
2162
2162
<a name="g-ascii-strtoll"></a>g_ascii_strtoll ()</h3>
2163
 
<a class="indexterm" name="id2837654"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint64">gint64</a>              g_ascii_strtoll                     (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *nptr,
 
2163
<a class="indexterm" name="id2850704"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint64">gint64</a>              g_ascii_strtoll                     (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *nptr,
2164
2164
                                                         <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> **endptr,
2165
2165
                                                         <a class="link" href="glib-Basic-Types.html#guint">guint</a> base);</pre>
2166
2166
<p>
2217
2217
</div>
2218
2218
<hr>
2219
2219
<div class="refsect2" lang="en">
2220
 
<a name="id2837924"></a><h3>
 
2220
<a name="id2850974"></a><h3>
2221
2221
<a name="g-ascii-strtoull"></a>g_ascii_strtoull ()</h3>
2222
 
<a class="indexterm" name="id2837939"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint64">guint64</a>             g_ascii_strtoull                    (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *nptr,
 
2222
<a class="indexterm" name="id2850989"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint64">guint64</a>             g_ascii_strtoull                    (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *nptr,
2223
2223
                                                         <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> **endptr,
2224
2224
                                                         <a class="link" href="glib-Basic-Types.html#guint">guint</a> base);</pre>
2225
2225
<p>
2276
2276
</div>
2277
2277
<hr>
2278
2278
<div class="refsect2" lang="en">
2279
 
<a name="id2838196"></a><h3>
 
2279
<a name="id2851246"></a><h3>
2280
2280
<a name="G-ASCII-DTOSTR-BUF-SIZE:CAPS"></a>G_ASCII_DTOSTR_BUF_SIZE</h3>
2281
 
<a class="indexterm" name="id2838210"></a><pre class="programlisting">#define G_ASCII_DTOSTR_BUF_SIZE (29 + 10)
 
2281
<a class="indexterm" name="id2851260"></a><pre class="programlisting">#define G_ASCII_DTOSTR_BUF_SIZE (29 + 10)
2282
2282
</pre>
2283
2283
<p>
2284
2284
A good size for a buffer to be passed into <a class="link" href="glib-String-Utility-Functions.html#g-ascii-dtostr"><code class="function">g_ascii_dtostr()</code></a>.
2298
2298
</div>
2299
2299
<hr>
2300
2300
<div class="refsect2" lang="en">
2301
 
<a name="id2838253"></a><h3>
 
2301
<a name="id2851303"></a><h3>
2302
2302
<a name="g-ascii-strtod"></a>g_ascii_strtod ()</h3>
2303
 
<a class="indexterm" name="id2838266"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gdouble">gdouble</a>             g_ascii_strtod                      (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *nptr,
 
2303
<a class="indexterm" name="id2851316"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gdouble">gdouble</a>             g_ascii_strtod                      (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *nptr,
2304
2304
                                                         <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> **endptr);</pre>
2305
2305
<p>
2306
2306
Converts a string to a <a class="link" href="glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> value.
2355
2355
</div>
2356
2356
<hr>
2357
2357
<div class="refsect2" lang="en">
2358
 
<a name="id2838513"></a><h3>
 
2358
<a name="id2851564"></a><h3>
2359
2359
<a name="g-ascii-dtostr"></a>g_ascii_dtostr ()</h3>
2360
 
<a class="indexterm" name="id2838526"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_ascii_dtostr                      (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *buffer,
 
2360
<a class="indexterm" name="id2851577"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_ascii_dtostr                      (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *buffer,
2361
2361
                                                         <a class="link" href="glib-Basic-Types.html#gint">gint</a> buf_len,
2362
2362
                                                         <a class="link" href="glib-Basic-Types.html#gdouble">gdouble</a> d);</pre>
2363
2363
<p>
2401
2401
</div>
2402
2402
<hr>
2403
2403
<div class="refsect2" lang="en">
2404
 
<a name="id2838672"></a><h3>
 
2404
<a name="id2851722"></a><h3>
2405
2405
<a name="g-ascii-formatd"></a>g_ascii_formatd ()</h3>
2406
 
<a class="indexterm" name="id2838685"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_ascii_formatd                     (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *buffer,
 
2406
<a class="indexterm" name="id2851735"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_ascii_formatd                     (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *buffer,
2407
2407
                                                         <a class="link" href="glib-Basic-Types.html#gint">gint</a> buf_len,
2408
2408
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *format,
2409
2409
                                                         <a class="link" href="glib-Basic-Types.html#gdouble">gdouble</a> d);</pre>
2453
2453
</div>
2454
2454
<hr>
2455
2455
<div class="refsect2" lang="en">
2456
 
<a name="id2838867"></a><h3>
 
2456
<a name="id2851917"></a><h3>
2457
2457
<a name="g-strtod"></a>g_strtod ()</h3>
2458
 
<a class="indexterm" name="id2838879"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gdouble">gdouble</a>             g_strtod                            (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *nptr,
 
2458
<a class="indexterm" name="id2851930"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gdouble">gdouble</a>             g_strtod                            (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *nptr,
2459
2459
                                                         <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> **endptr);</pre>
2460
2460
<p>
2461
2461
Converts a string to a <a class="link" href="glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> value.
2497
2497
</div>
2498
2498
<hr>
2499
2499
<div class="refsect2" lang="en">
2500
 
<a name="id2839033"></a><h3>
 
2500
<a name="id2852084"></a><h3>
2501
2501
<a name="g-strchug"></a>g_strchug ()</h3>
2502
 
<a class="indexterm" name="id2839046"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_strchug                           (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string);</pre>
 
2502
<a class="indexterm" name="id2852096"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_strchug                           (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string);</pre>
2503
2503
<p>
2504
2504
Removes leading whitespace from a string, by moving the rest of the
2505
2505
characters forward.
2532
2532
</div>
2533
2533
<hr>
2534
2534
<div class="refsect2" lang="en">
2535
 
<a name="id2839151"></a><h3>
 
2535
<a name="id2852201"></a><h3>
2536
2536
<a name="g-strchomp"></a>g_strchomp ()</h3>
2537
 
<a class="indexterm" name="id2839164"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_strchomp                          (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string);</pre>
 
2537
<a class="indexterm" name="id2852214"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_strchomp                          (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string);</pre>
2538
2538
<p>
2539
2539
Removes trailing whitespace from a string.
2540
2540
</p>
2566
2566
</div>
2567
2567
<hr>
2568
2568
<div class="refsect2" lang="en">
2569
 
<a name="id2839268"></a><h3>
 
2569
<a name="id2852318"></a><h3>
2570
2570
<a name="g-strstrip"></a>g_strstrip()</h3>
2571
 
<a class="indexterm" name="id2839281"></a><pre class="programlisting">#define             g_strstrip( string )</pre>
 
2571
<a class="indexterm" name="id2852331"></a><pre class="programlisting">#define             g_strstrip( string )</pre>
2572
2572
<p>
2573
2573
Removes leading and trailing whitespace from a string. See <a class="link" href="glib-String-Utility-Functions.html#g-strchomp"><code class="function">g_strchomp()</code></a> and
2574
2574
<a class="link" href="glib-String-Utility-Functions.html#g-strchug"><code class="function">g_strchug()</code></a>.
2586
2586
</div>
2587
2587
<hr>
2588
2588
<div class="refsect2" lang="en">
2589
 
<a name="id2839337"></a><h3>
 
2589
<a name="id2852387"></a><h3>
2590
2590
<a name="g-strdelimit"></a>g_strdelimit ()</h3>
2591
 
<a class="indexterm" name="id2839350"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_strdelimit                        (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string,
 
2591
<a class="indexterm" name="id2852400"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_strdelimit                        (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string,
2592
2592
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *delimiters,
2593
2593
                                                         <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> new_delimiter);</pre>
2594
2594
<p>
2630
2630
</div>
2631
2631
<hr>
2632
2632
<div class="refsect2" lang="en">
2633
 
<a name="id2839528"></a><h3>
 
2633
<a name="id2852578"></a><h3>
2634
2634
<a name="G-STR-DELIMITERS:CAPS"></a>G_STR_DELIMITERS</h3>
2635
 
<a class="indexterm" name="id2839541"></a><pre class="programlisting">#define    G_STR_DELIMITERS       "_-|&gt; &lt;."
 
2635
<a class="indexterm" name="id2852591"></a><pre class="programlisting">#define    G_STR_DELIMITERS       "_-|&gt; &lt;."
2636
2636
</pre>
2637
2637
<p>
2638
2638
The standard delimiters, used in <a class="link" href="glib-String-Utility-Functions.html#g-strdelimit"><code class="function">g_strdelimit()</code></a>.
2640
2640
</div>
2641
2641
<hr>
2642
2642
<div class="refsect2" lang="en">
2643
 
<a name="id2839568"></a><h3>
 
2643
<a name="id2852618"></a><h3>
2644
2644
<a name="g-strescape"></a>g_strescape ()</h3>
2645
 
<a class="indexterm" name="id2839580"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_strescape                         (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *source,
 
2645
<a class="indexterm" name="id2852630"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_strescape                         (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *source,
2646
2646
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *exceptions);</pre>
2647
2647
<p>
2648
2648
Escapes the special characters '\b', '\f', '\n', '\r', '\t', '\' and
2681
2681
</div>
2682
2682
<hr>
2683
2683
<div class="refsect2" lang="en">
2684
 
<a name="id2839705"></a><h3>
 
2684
<a name="id2852755"></a><h3>
2685
2685
<a name="g-strcompress"></a>g_strcompress ()</h3>
2686
 
<a class="indexterm" name="id2839718"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_strcompress                       (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *source);</pre>
 
2686
<a class="indexterm" name="id2852768"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_strcompress                       (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *source);</pre>
2687
2687
<p>
2688
2688
Replaces all escaped characters with their one byte equivalent. It
2689
2689
does the reverse conversion of <a class="link" href="glib-String-Utility-Functions.html#g-strescape"><code class="function">g_strescape()</code></a>. 
2709
2709
</div>
2710
2710
<hr>
2711
2711
<div class="refsect2" lang="en">
2712
 
<a name="id2839793"></a><h3>
 
2712
<a name="id2852844"></a><h3>
2713
2713
<a name="g-strcanon"></a>g_strcanon ()</h3>
2714
 
<a class="indexterm" name="id2839806"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_strcanon                          (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string,
 
2714
<a class="indexterm" name="id2852856"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_strcanon                          (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string,
2715
2715
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *valid_chars,
2716
2716
                                                         <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> substitutor);</pre>
2717
2717
<p>
2751
2751
</div>
2752
2752
<hr>
2753
2753
<div class="refsect2" lang="en">
2754
 
<a name="id2839957"></a><h3>
 
2754
<a name="id2853007"></a><h3>
2755
2755
<a name="g-strsplit"></a>g_strsplit ()</h3>
2756
 
<a class="indexterm" name="id2839970"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>**             g_strsplit                          (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string,
 
2756
<a class="indexterm" name="id2853020"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>**             g_strsplit                          (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string,
2757
2757
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *delimiter,
2758
2758
                                                         <a class="link" href="glib-Basic-Types.html#gint">gint</a> max_tokens);</pre>
2759
2759
<p>
2802
2802
</div>
2803
2803
<hr>
2804
2804
<div class="refsect2" lang="en">
2805
 
<a name="id2840156"></a><h3>
 
2805
<a name="id2853207"></a><h3>
2806
2806
<a name="g-strsplit-set"></a>g_strsplit_set ()</h3>
2807
 
<a class="indexterm" name="id2840172"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>**             g_strsplit_set                      (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string,
 
2807
<a class="indexterm" name="id2853222"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>**             g_strsplit_set                      (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string,
2808
2808
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *delimiters,
2809
2809
                                                         <a class="link" href="glib-Basic-Types.html#gint">gint</a> max_tokens);</pre>
2810
2810
<p>
2870
2870
</div>
2871
2871
<hr>
2872
2872
<div class="refsect2" lang="en">
2873
 
<a name="id2840397"></a><h3>
 
2873
<a name="id2853448"></a><h3>
2874
2874
<a name="g-strfreev"></a>g_strfreev ()</h3>
2875
 
<a class="indexterm" name="id2840410"></a><pre class="programlisting">void                g_strfreev                          (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> **str_array);</pre>
 
2875
<a class="indexterm" name="id2853460"></a><pre class="programlisting">void                g_strfreev                          (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> **str_array);</pre>
2876
2876
<p>
2877
2877
Frees a <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of strings, and the array itself.
2878
2878
If called on a <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> value, <a class="link" href="glib-String-Utility-Functions.html#g-strfreev"><code class="function">g_strfreev()</code></a> simply returns.</p>
2890
2890
</div>
2891
2891
<hr>
2892
2892
<div class="refsect2" lang="en">
2893
 
<a name="id2840502"></a><h3>
 
2893
<a name="id2853553"></a><h3>
2894
2894
<a name="g-strconcat"></a>g_strconcat ()</h3>
2895
 
<a class="indexterm" name="id2840515"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_strconcat                         (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string1,
 
2895
<a class="indexterm" name="id2853565"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_strconcat                         (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string1,
2896
2896
                                                         ...);</pre>
2897
2897
<p>
2898
2898
Concatenates all of the given strings into one long string.  The returned string
2931
2931
</div>
2932
2932
<hr>
2933
2933
<div class="refsect2" lang="en">
2934
 
<a name="id2840651"></a><h3>
 
2934
<a name="id2853701"></a><h3>
2935
2935
<a name="g-strjoin"></a>g_strjoin ()</h3>
2936
 
<a class="indexterm" name="id2840664"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_strjoin                           (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *separator,
 
2936
<a class="indexterm" name="id2853714"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_strjoin                           (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *separator,
2937
2937
                                                         ...);</pre>
2938
2938
<p>
2939
2939
Joins a number of strings together to form one long string, with the optional
2965
2965
</div>
2966
2966
<hr>
2967
2967
<div class="refsect2" lang="en">
2968
 
<a name="id2840771"></a><h3>
 
2968
<a name="id2853822"></a><h3>
2969
2969
<a name="g-strjoinv"></a>g_strjoinv ()</h3>
2970
 
<a class="indexterm" name="id2840784"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_strjoinv                          (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *separator,
 
2970
<a class="indexterm" name="id2853834"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_strjoinv                          (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *separator,
2971
2971
                                                         <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> **str_array);</pre>
2972
2972
<p>
2973
2973
Joins a number of strings together to form one long string, with the optional
2999
2999
</div>
3000
3000
<hr>
3001
3001
<div class="refsect2" lang="en">
3002
 
<a name="id2840899"></a><h3>
 
3002
<a name="id2853949"></a><h3>
3003
3003
<a name="g-strv-length"></a>g_strv_length ()</h3>
3004
 
<a class="indexterm" name="id2840914"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint">guint</a>               g_strv_length                       (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> **str_array);</pre>
 
3004
<a class="indexterm" name="id2853964"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint">guint</a>               g_strv_length                       (<a class="link" href="glib-Basic-Types.html#gchar">gchar</a> **str_array);</pre>
3005
3005
<p>
3006
3006
Returns the length of the given <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated 
3007
3007
string array <em class="parameter"><code>str_array</code></em>.</p>
3029
3029
</div>
3030
3030
<hr>
3031
3031
<div class="refsect2" lang="en">
3032
 
<a name="id2841014"></a><h3>
 
3032
<a name="id2854064"></a><h3>
3033
3033
<a name="g-strerror"></a>g_strerror ()</h3>
3034
 
<a class="indexterm" name="id2841026"></a><pre class="programlisting">const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*        g_strerror                          (<a class="link" href="glib-Basic-Types.html#gint">gint</a> errnum);</pre>
 
3034
<a class="indexterm" name="id2854076"></a><pre class="programlisting">const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*        g_strerror                          (<a class="link" href="glib-Basic-Types.html#gint">gint</a> errnum);</pre>
3035
3035
<p>
3036
3036
Returns a string corresponding to the given error code, e.g. "no such process".
3037
3037
You should use this function in preference to <code class="function">strerror()</code>, because it returns a
3061
3061
</div>
3062
3062
<hr>
3063
3063
<div class="refsect2" lang="en">
3064
 
<a name="id2841134"></a><h3>
 
3064
<a name="id2854184"></a><h3>
3065
3065
<a name="g-strsignal"></a>g_strsignal ()</h3>
3066
 
<a class="indexterm" name="id2841147"></a><pre class="programlisting">const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*        g_strsignal                         (<a class="link" href="glib-Basic-Types.html#gint">gint</a> signum);</pre>
 
3066
<a class="indexterm" name="id2854197"></a><pre class="programlisting">const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*        g_strsignal                         (<a class="link" href="glib-Basic-Types.html#gint">gint</a> signum);</pre>
3067
3067
<p>
3068
3068
Returns a string describing the given signal, e.g. "Segmentation fault".
3069
3069
You should use this function in preference to <code class="function">strsignal()</code>, because it returns a
3093
3093
</div>
3094
3094
</div>
3095
3095
<div class="refsect1" lang="en">
3096
 
<a name="id2841251"></a><div class="refsect2" lang="en"><a name="id2841252"></a></div>
 
3096
<a name="id2854301"></a><div class="refsect2" lang="en"><a name="id2854302"></a></div>
3097
3097
<hr>
3098
 
<div class="refsect2" lang="en"><a name="id2841253"></a></div>
 
3098
<div class="refsect2" lang="en"><a name="id2854303"></a></div>
3099
3099
</div>
3100
3100
</div>
3101
3101
</body>