← Back to branch summary

~ubuntu-branches/debian/jessie/glib2.0/jessie

« back to all changes in this revision

Viewing changes to docs/reference/glib/html/glib-Strings.html

Tags: upstream-2.16.1
Import upstream version 2.16.1

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/glib/html/glib-Strings.html
36
36
<th width="100%" align="center">GLib Reference Manual</th>
37
37
<td><a accesskey="n" href="glib-String-Chunks.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="#id3177254" class="shortcut">Top</a>
 
39
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id3300362" class="shortcut">Top</a>
40
40
                  &#160;|&#160;
41
 
                  <a href="#id3178327" class="shortcut">Description</a></nobr></td></tr>
 
41
                  <a href="#id3301435" class="shortcut">Description</a></nobr></td></tr>
42
42
</table>
43
43
<div class="refentry" lang="en">
44
44
<a name="glib-Strings"></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="id3177254"></a><span class="refentrytitle">Strings</span>
 
48
<a name="id3300362"></a><span class="refentrytitle">Strings</span>
49
49
</h2>
50
50
<p>Strings &#8212; text buffers which grow automatically as text is added</p>
51
51
</td>
140
140
</pre>
141
141
</div>
142
142
<div class="refsect1" lang="en">
143
 
<a name="id3178327"></a><h2>Description</h2>
 
143
<a name="id3301435"></a><h2>Description</h2>
144
144
<p>
145
145
A <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a> is similar to a standard C string, except that it grows 
146
146
automatically as text is appended or inserted. Also, it stores the 
149
149
</p>
150
150
</div>
151
151
<div class="refsect1" lang="en">
152
 
<a name="id3178352"></a><h2>Details</h2>
 
152
<a name="id3301461"></a><h2>Details</h2>
153
153
<div class="refsect2" lang="en">
154
 
<a name="id3178363"></a><h3>
 
154
<a name="id3301471"></a><h3>
155
155
<a name="GString"></a>GString</h3>
156
 
<a class="indexterm" name="id3178375"></a><pre class="programlisting">typedef struct {
 
156
<a class="indexterm" name="id3301484"></a><pre class="programlisting">typedef struct {
157
157
  gchar  *str;
158
158
  gsize len;    
159
159
  gsize allocated_len;
190
190
</div>
191
191
<hr>
192
192
<div class="refsect2" lang="en">
193
 
<a name="id3178486"></a><h3>
 
193
<a name="id3301595"></a><h3>
194
194
<a name="g-string-new"></a>g_string_new ()</h3>
195
 
<a class="indexterm" name="id3178499"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_new                        (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *init);</pre>
 
195
<a class="indexterm" name="id3301608"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_new                        (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *init);</pre>
196
196
<p>
197
197
Creates a new <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a>, initialized with the given string.</p>
198
198
<p>
216
216
</div>
217
217
<hr>
218
218
<div class="refsect2" lang="en">
219
 
<a name="id3178576"></a><h3>
 
219
<a name="id3301685"></a><h3>
220
220
<a name="g-string-new-len"></a>g_string_new_len ()</h3>
221
 
<a class="indexterm" name="id3178588"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_new_len                    (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *init,
 
221
<a class="indexterm" name="id3301697"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_new_len                    (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *init,
222
222
                                                         <a class="link" href="glib-Basic-Types.html#gssize">gssize</a> len);</pre>
223
223
<p>
224
224
Creates a new <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a> with <em class="parameter"><code>len</code></em> bytes of the <em class="parameter"><code>init</code></em> buffer.  
255
255
</div>
256
256
<hr>
257
257
<div class="refsect2" lang="en">
258
 
<a name="id3178729"></a><h3>
 
258
<a name="id3301837"></a><h3>
259
259
<a name="g-string-sized-new"></a>g_string_sized_new ()</h3>
260
 
<a class="indexterm" name="id3178742"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_sized_new                  (<a class="link" href="glib-Basic-Types.html#gsize">gsize</a> dfl_size);</pre>
 
260
<a class="indexterm" name="id3301850"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_sized_new                  (<a class="link" href="glib-Basic-Types.html#gsize">gsize</a> dfl_size);</pre>
261
261
<p>
262
262
Creates a new <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a>, with enough space for <em class="parameter"><code>dfl_size</code></em> 
263
263
bytes. This is useful if you are going to add a lot of 
285
285
</div>
286
286
<hr>
287
287
<div class="refsect2" lang="en">
288
 
<a name="id3178827"></a><h3>
 
288
<a name="id3301935"></a><h3>
289
289
<a name="g-string-assign"></a>g_string_assign ()</h3>
290
 
<a class="indexterm" name="id3178840"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_assign                     (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
 
290
<a class="indexterm" name="id3301948"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_assign                     (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
291
291
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *rval);</pre>
292
292
<p>
293
293
Copies the bytes from a string into a <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a>, 
321
321
</div>
322
322
<hr>
323
323
<div class="refsect2" lang="en">
324
 
<a name="id3178963"></a><h3>
 
324
<a name="id3302072"></a><h3>
325
325
<a name="g-string-sprintf"></a>g_string_sprintf</h3>
326
 
<a class="indexterm" name="id3178979"></a><pre class="programlisting">#define             g_string_sprintf</pre>
 
326
<a class="indexterm" name="id3302088"></a><pre class="programlisting">#define             g_string_sprintf</pre>
327
327
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
328
328
<h3 class="title">Warning</h3>
329
329
<p><code class="literal">g_string_sprintf</code> is deprecated and should not be used in newly-written code. This function has been renamed to <a class="link" href="glib-Strings.html#g-string-printf"><code class="function">g_string_printf()</code></a>.</p>
360
360
</div>
361
361
<hr>
362
362
<div class="refsect2" lang="en">
363
 
<a name="id3179123"></a><h3>
 
363
<a name="id3302231"></a><h3>
364
364
<a name="g-string-sprintfa"></a>g_string_sprintfa</h3>
365
 
<a class="indexterm" name="id3179138"></a><pre class="programlisting">#define             g_string_sprintfa</pre>
 
365
<a class="indexterm" name="id3302247"></a><pre class="programlisting">#define             g_string_sprintfa</pre>
366
366
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
367
367
<h3 class="title">Warning</h3>
368
368
<p><code class="literal">g_string_sprintfa</code> is deprecated and should not be used in newly-written code. This function has been renamed to <a class="link" href="glib-Strings.html#g-string-append-printf"><code class="function">g_string_append_printf()</code></a></p>
397
397
</div>
398
398
<hr>
399
399
<div class="refsect2" lang="en">
400
 
<a name="id3179272"></a><h3>
 
400
<a name="id3302381"></a><h3>
401
401
<a name="g-string-vprintf"></a>g_string_vprintf ()</h3>
402
 
<a class="indexterm" name="id3179288"></a><pre class="programlisting">void                g_string_vprintf                    (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
 
402
<a class="indexterm" name="id3302396"></a><pre class="programlisting">void                g_string_vprintf                    (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
403
403
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *format,
404
404
                                                         va_list args);</pre>
405
405
<p>
434
434
</div>
435
435
<hr>
436
436
<div class="refsect2" lang="en">
437
 
<a name="id3179427"></a><h3>
 
437
<a name="id3302536"></a><h3>
438
438
<a name="g-string-append-vprintf"></a>g_string_append_vprintf ()</h3>
439
 
<a class="indexterm" name="id3179443"></a><pre class="programlisting">void                g_string_append_vprintf             (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
 
439
<a class="indexterm" name="id3302552"></a><pre class="programlisting">void                g_string_append_vprintf             (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
440
440
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *format,
441
441
                                                         va_list args);</pre>
442
442
<p>
472
472
</div>
473
473
<hr>
474
474
<div class="refsect2" lang="en">
475
 
<a name="id3179583"></a><h3>
 
475
<a name="id3302692"></a><h3>
476
476
<a name="g-string-printf"></a>g_string_printf ()</h3>
477
 
<a class="indexterm" name="id3179596"></a><pre class="programlisting">void                g_string_printf                     (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
 
477
<a class="indexterm" name="id3302705"></a><pre class="programlisting">void                g_string_printf                     (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
478
478
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *format,
479
479
                                                         ...);</pre>
480
480
<p>
509
509
</div>
510
510
<hr>
511
511
<div class="refsect2" lang="en">
512
 
<a name="id3179738"></a><h3>
 
512
<a name="id3302847"></a><h3>
513
513
<a name="g-string-append-printf"></a>g_string_append_printf ()</h3>
514
 
<a class="indexterm" name="id3179752"></a><pre class="programlisting">void                g_string_append_printf              (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
 
514
<a class="indexterm" name="id3302860"></a><pre class="programlisting">void                g_string_append_printf              (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
515
515
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *format,
516
516
                                                         ...);</pre>
517
517
<p>
544
544
</div>
545
545
<hr>
546
546
<div class="refsect2" lang="en">
547
 
<a name="id3179885"></a><h3>
 
547
<a name="id3302993"></a><h3>
548
548
<a name="g-string-append"></a>g_string_append ()</h3>
549
 
<a class="indexterm" name="id3179898"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_append                     (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
 
549
<a class="indexterm" name="id3303006"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_append                     (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
550
550
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *val);</pre>
551
551
<p>
552
552
Adds a string onto the end of a <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a>, expanding 
577
577
</div>
578
578
<hr>
579
579
<div class="refsect2" lang="en">
580
 
<a name="id3180007"></a><h3>
 
580
<a name="id3303116"></a><h3>
581
581
<a name="g-string-append-c"></a>g_string_append_c ()</h3>
582
 
<a class="indexterm" name="id3180021"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_append_c                   (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
 
582
<a class="indexterm" name="id3303129"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_append_c                   (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
583
583
                                                         <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> c);</pre>
584
584
<p>
585
585
Adds a byte onto the end of a <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a>, expanding 
610
610
</div>
611
611
<hr>
612
612
<div class="refsect2" lang="en">
613
 
<a name="id3180130"></a><h3>
 
613
<a name="id3303238"></a><h3>
614
614
<a name="g-string-append-unichar"></a>g_string_append_unichar ()</h3>
615
 
<a class="indexterm" name="id3180143"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_append_unichar             (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
 
615
<a class="indexterm" name="id3303252"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_append_unichar             (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
616
616
                                                         <a class="link" href="glib-Unicode-Manipulation.html#gunichar">gunichar</a> wc);</pre>
617
617
<p>
618
618
Converts a Unicode character into UTF-8, and appends it
643
643
</div>
644
644
<hr>
645
645
<div class="refsect2" lang="en">
646
 
<a name="id3180239"></a><h3>
 
646
<a name="id3303348"></a><h3>
647
647
<a name="g-string-append-len"></a>g_string_append_len ()</h3>
648
 
<a class="indexterm" name="id3180253"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_append_len                 (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
 
648
<a class="indexterm" name="id3303362"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_append_len                 (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
649
649
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *val,
650
650
                                                         <a class="link" href="glib-Basic-Types.html#gssize">gssize</a> len);</pre>
651
651
<p>
688
688
</div>
689
689
<hr>
690
690
<div class="refsect2" lang="en">
691
 
<a name="id3180421"></a><h3>
 
691
<a name="id3303530"></a><h3>
692
692
<a name="g-string-append-uri-escaped"></a>g_string_append_uri_escaped ()</h3>
693
 
<a class="indexterm" name="id3180437"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_append_uri_escaped         (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
 
693
<a class="indexterm" name="id3303546"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_append_uri_escaped         (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
694
694
                                                         const char *unescaped,
695
695
                                                         const char *reserved_chars_allowed,
696
696
                                                         <a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> allow_utf8);</pre>
736
736
</div>
737
737
<hr>
738
738
<div class="refsect2" lang="en">
739
 
<a name="id3180608"></a><h3>
 
739
<a name="id3303717"></a><h3>
740
740
<a name="g-string-prepend"></a>g_string_prepend ()</h3>
741
 
<a class="indexterm" name="id3180620"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_prepend                    (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
 
741
<a class="indexterm" name="id3303729"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_prepend                    (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
742
742
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *val);</pre>
743
743
<p>
744
744
Adds a string on to the start of a <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a>, 
769
769
</div>
770
770
<hr>
771
771
<div class="refsect2" lang="en">
772
 
<a name="id3180730"></a><h3>
 
772
<a name="id3303839"></a><h3>
773
773
<a name="g-string-prepend-c"></a>g_string_prepend_c ()</h3>
774
 
<a class="indexterm" name="id3180744"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_prepend_c                  (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
 
774
<a class="indexterm" name="id3303852"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_prepend_c                  (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
775
775
                                                         <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> c);</pre>
776
776
<p>
777
777
Adds a byte onto the start of a <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a>, 
802
802
</div>
803
803
<hr>
804
804
<div class="refsect2" lang="en">
805
 
<a name="id3180855"></a><h3>
 
805
<a name="id3303963"></a><h3>
806
806
<a name="g-string-prepend-unichar"></a>g_string_prepend_unichar ()</h3>
807
 
<a class="indexterm" name="id3180868"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_prepend_unichar            (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
 
807
<a class="indexterm" name="id3303976"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_prepend_unichar            (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
808
808
                                                         <a class="link" href="glib-Unicode-Manipulation.html#gunichar">gunichar</a> wc);</pre>
809
809
<p>
810
810
Converts a Unicode character into UTF-8, and prepends it
835
835
</div>
836
836
<hr>
837
837
<div class="refsect2" lang="en">
838
 
<a name="id3180963"></a><h3>
 
838
<a name="id3304072"></a><h3>
839
839
<a name="g-string-prepend-len"></a>g_string_prepend_len ()</h3>
840
 
<a class="indexterm" name="id3180977"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_prepend_len                (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
 
840
<a class="indexterm" name="id3304085"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_prepend_len                (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
841
841
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *val,
842
842
                                                         <a class="link" href="glib-Basic-Types.html#gssize">gssize</a> len);</pre>
843
843
<p>
880
880
</div>
881
881
<hr>
882
882
<div class="refsect2" lang="en">
883
 
<a name="id3181146"></a><h3>
 
883
<a name="id3304254"></a><h3>
884
884
<a name="g-string-insert"></a>g_string_insert ()</h3>
885
 
<a class="indexterm" name="id3181159"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_insert                     (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
 
885
<a class="indexterm" name="id3304267"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_insert                     (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
886
886
                                                         <a class="link" href="glib-Basic-Types.html#gssize">gssize</a> pos,
887
887
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *val);</pre>
888
888
<p>
919
919
</div>
920
920
<hr>
921
921
<div class="refsect2" lang="en">
922
 
<a name="id3181284"></a><h3>
 
922
<a name="id3304393"></a><h3>
923
923
<a name="g-string-insert-c"></a>g_string_insert_c ()</h3>
924
 
<a class="indexterm" name="id3181298"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_insert_c                   (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
 
924
<a class="indexterm" name="id3304406"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_insert_c                   (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
925
925
                                                         <a class="link" href="glib-Basic-Types.html#gssize">gssize</a> pos,
926
926
                                                         <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> c);</pre>
927
927
<p>
957
957
</div>
958
958
<hr>
959
959
<div class="refsect2" lang="en">
960
 
<a name="id3181422"></a><h3>
 
960
<a name="id3304531"></a><h3>
961
961
<a name="g-string-insert-unichar"></a>g_string_insert_unichar ()</h3>
962
 
<a class="indexterm" name="id3181436"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_insert_unichar             (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
 
962
<a class="indexterm" name="id3304544"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_insert_unichar             (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
963
963
                                                         <a class="link" href="glib-Basic-Types.html#gssize">gssize</a> pos,
964
964
                                                         <a class="link" href="glib-Unicode-Manipulation.html#gunichar">gunichar</a> wc);</pre>
965
965
<p>
997
997
</div>
998
998
<hr>
999
999
<div class="refsect2" lang="en">
1000
 
<a name="id3181555"></a><h3>
 
1000
<a name="id3304663"></a><h3>
1001
1001
<a name="g-string-insert-len"></a>g_string_insert_len ()</h3>
1002
 
<a class="indexterm" name="id3181568"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_insert_len                 (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
 
1002
<a class="indexterm" name="id3304677"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_insert_len                 (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
1003
1003
                                                         <a class="link" href="glib-Basic-Types.html#gssize">gssize</a> pos,
1004
1004
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *val,
1005
1005
                                                         <a class="link" href="glib-Basic-Types.html#gssize">gssize</a> len);</pre>
1050
1050
</div>
1051
1051
<hr>
1052
1052
<div class="refsect2" lang="en">
1053
 
<a name="id3181777"></a><h3>
 
1053
<a name="id3304886"></a><h3>
1054
1054
<a name="g-string-overwrite"></a>g_string_overwrite ()</h3>
1055
 
<a class="indexterm" name="id3181792"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_overwrite                  (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
 
1055
<a class="indexterm" name="id3304901"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_overwrite                  (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
1056
1056
                                                         <a class="link" href="glib-Basic-Types.html#gsize">gsize</a> pos,
1057
1057
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *val);</pre>
1058
1058
<p>
1091
1091
</div>
1092
1092
<hr>
1093
1093
<div class="refsect2" lang="en">
1094
 
<a name="id3181929"></a><h3>
 
1094
<a name="id3305037"></a><h3>
1095
1095
<a name="g-string-overwrite-len"></a>g_string_overwrite_len ()</h3>
1096
 
<a class="indexterm" name="id3181944"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_overwrite_len              (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
 
1096
<a class="indexterm" name="id3305053"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_overwrite_len              (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
1097
1097
                                                         <a class="link" href="glib-Basic-Types.html#gsize">gsize</a> pos,
1098
1098
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *val,
1099
1099
                                                         <a class="link" href="glib-Basic-Types.html#gssize">gssize</a> len);</pre>
1139
1139
</div>
1140
1140
<hr>
1141
1141
<div class="refsect2" lang="en">
1142
 
<a name="id3182109"></a><h3>
 
1142
<a name="id3305218"></a><h3>
1143
1143
<a name="g-string-erase"></a>g_string_erase ()</h3>
1144
 
<a class="indexterm" name="id3182121"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_erase                      (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
 
1144
<a class="indexterm" name="id3305230"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_erase                      (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
1145
1145
                                                         <a class="link" href="glib-Basic-Types.html#gssize">gssize</a> pos,
1146
1146
                                                         <a class="link" href="glib-Basic-Types.html#gssize">gssize</a> len);</pre>
1147
1147
<p>
1179
1179
</div>
1180
1180
<hr>
1181
1181
<div class="refsect2" lang="en">
1182
 
<a name="id3182267"></a><h3>
 
1182
<a name="id3305376"></a><h3>
1183
1183
<a name="g-string-truncate"></a>g_string_truncate ()</h3>
1184
 
<a class="indexterm" name="id3182280"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_truncate                   (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
 
1184
<a class="indexterm" name="id3305389"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_truncate                   (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
1185
1185
                                                         <a class="link" href="glib-Basic-Types.html#gsize">gsize</a> len);</pre>
1186
1186
<p>
1187
1187
Cuts off the end of the GString, leaving the first <em class="parameter"><code>len</code></em> bytes.</p>
1211
1211
</div>
1212
1212
<hr>
1213
1213
<div class="refsect2" lang="en">
1214
 
<a name="id3182386"></a><h3>
 
1214
<a name="id3305495"></a><h3>
1215
1215
<a name="g-string-set-size"></a>g_string_set_size ()</h3>
1216
 
<a class="indexterm" name="id3182399"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_set_size                   (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
 
1216
<a class="indexterm" name="id3305508"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_set_size                   (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
1217
1217
                                                         <a class="link" href="glib-Basic-Types.html#gsize">gsize</a> len);</pre>
1218
1218
<p>
1219
1219
Sets the length of a <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a>. If the length is less than
1247
1247
</div>
1248
1248
<hr>
1249
1249
<div class="refsect2" lang="en">
1250
 
<a name="id3182506"></a><h3>
 
1250
<a name="id3305614"></a><h3>
1251
1251
<a name="g-string-free"></a>g_string_free ()</h3>
1252
 
<a class="indexterm" name="id3182519"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_string_free                       (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
 
1252
<a class="indexterm" name="id3305627"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_string_free                       (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
1253
1253
                                                         <a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> free_segment);</pre>
1254
1254
<p>
1255
1255
Frees the memory allocated for the <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a>.
1281
1281
</div>
1282
1282
<hr>
1283
1283
<div class="refsect2" lang="en">
1284
 
<a name="id3182677"></a><h3>
 
1284
<a name="id3305786"></a><h3>
1285
1285
<a name="g-string-up"></a>g_string_up ()</h3>
1286
 
<a class="indexterm" name="id3182692"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_up                         (<a class="link" href="glib-Strings.html#GString">GString</a> *string);</pre>
 
1286
<a class="indexterm" name="id3305801"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_up                         (<a class="link" href="glib-Strings.html#GString">GString</a> *string);</pre>
1287
1287
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1288
1288
<h3 class="title">Warning</h3>
1289
1289
<p><code class="literal">g_string_up</code> has been deprecated since version 2.2 and should not be used in newly-written code. This function uses the locale-specific 
1313
1313
</div>
1314
1314
<hr>
1315
1315
<div class="refsect2" lang="en">
1316
 
<a name="id3182819"></a><h3>
 
1316
<a name="id3305928"></a><h3>
1317
1317
<a name="g-string-down"></a>g_string_down ()</h3>
1318
 
<a class="indexterm" name="id3182834"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_down                       (<a class="link" href="glib-Strings.html#GString">GString</a> *string);</pre>
 
1318
<a class="indexterm" name="id3305943"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_down                       (<a class="link" href="glib-Strings.html#GString">GString</a> *string);</pre>
1319
1319
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1320
1320
<h3 class="title">Warning</h3>
1321
1321
<p><code class="literal">g_string_down</code> has been deprecated since version 2.2 and should not be used in newly-written code. This function uses the locale-specific 
1345
1345
</div>
1346
1346
<hr>
1347
1347
<div class="refsect2" lang="en">
1348
 
<a name="id3182964"></a><h3>
 
1348
<a name="id3306072"></a><h3>
1349
1349
<a name="g-string-hash"></a>g_string_hash ()</h3>
1350
 
<a class="indexterm" name="id3182977"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint">guint</a>               g_string_hash                       (const <a class="link" href="glib-Strings.html#GString">GString</a> *str);</pre>
 
1350
<a class="indexterm" name="id3306085"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint">guint</a>               g_string_hash                       (const <a class="link" href="glib-Strings.html#GString">GString</a> *str);</pre>
1351
1351
<p>
1352
1352
Creates a hash code for <em class="parameter"><code>str</code></em>; for use with <a class="link" href="glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a>.</p>
1353
1353
<p>
1371
1371
</div>
1372
1372
<hr>
1373
1373
<div class="refsect2" lang="en">
1374
 
<a name="id3183056"></a><h3>
 
1374
<a name="id3306165"></a><h3>
1375
1375
<a name="g-string-equal"></a>g_string_equal ()</h3>
1376
 
<a class="indexterm" name="id3183069"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_string_equal                      (const <a class="link" href="glib-Strings.html#GString">GString</a> *v,
 
1376
<a class="indexterm" name="id3306178"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_string_equal                      (const <a class="link" href="glib-Strings.html#GString">GString</a> *v,
1377
1377
                                                         const <a class="link" href="glib-Strings.html#GString">GString</a> *v2);</pre>
1378
1378
<p>
1379
1379
Compares two strings for equality, returning <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if they are equal. 
1405
1405
</div>
1406
1406
</div>
1407
1407
<div class="refsect1" lang="en">
1408
 
<a name="id3183197"></a><div class="refsect2" lang="en"><a name="id3183198"></a></div>
 
1408
<a name="id3306306"></a><div class="refsect2" lang="en"><a name="id3306307"></a></div>
1409
1409
<hr>
1410
 
<div class="refsect2" lang="en"><a name="id3183199"></a></div>
 
1410
<div class="refsect2" lang="en"><a name="id3306308"></a></div>
1411
1411
</div>
1412
1412
</div>
1413
1413
</body>