<!-- ##### SECTION Title ##### -->
Strings

<!-- ##### SECTION Short_Description ##### -->
text buffers which grow automatically as text is added

<!-- ##### SECTION Long_Description ##### -->
<para>
A #GString is an object that handles the memory management of a C string
for you. You can think of it as similar to a Java StringBuffer.
In addition to the string itself, GString stores the length of the string,
so can be used for binary data with embedded nul bytes. To access the C
string managed by the GString @string, simply use @string->str.
</para>

<!-- ##### SECTION See_Also ##### -->
<para>

</para>

<!-- ##### SECTION Stability_Level ##### -->


<!-- ##### SECTION Image ##### -->


<!-- ##### STRUCT GString ##### -->
<para>
The #GString struct contains the public fields of a #GString.
</para>

@str: points to the character data. It may move as text is added.
  The <structfield>str</structfield> field is nul-terminated and so 
  can be used as an ordinary C string.
@len: contains the length of the string, not including the 
  terminating nul byte.
@allocated_len: the number of bytes that can be stored in the
  string before it needs to be reallocated. May be larger than @len.

<!-- ##### FUNCTION g_string_new ##### -->
<para>

</para>

@init: 
@Returns: 


<!-- ##### FUNCTION g_string_new_len ##### -->
<para>

</para>

@init: 
@len: 
@Returns: 


<!-- ##### FUNCTION g_string_sized_new ##### -->
<para>

</para>

@dfl_size: 
@Returns: 


<!-- ##### FUNCTION g_string_assign ##### -->
<para>

</para>

@string: 
@rval: 
@Returns: 


<!-- ##### MACRO g_string_sprintf ##### -->
<para>

</para>



<!-- ##### MACRO g_string_sprintfa ##### -->
<para>

</para>



<!-- ##### FUNCTION g_string_vprintf ##### -->
<para>

</para>

@string: 
@format: 
@args: 


<!-- ##### FUNCTION g_string_append_vprintf ##### -->
<para>

</para>

@string: 
@format: 
@args: 


<!-- ##### FUNCTION g_string_printf ##### -->
<para>

</para>

@string: 
@format: 
@...: 


<!-- ##### FUNCTION g_string_append_printf ##### -->
<para>

</para>

@string: 
@format: 
@...: 


<!-- ##### FUNCTION g_string_append ##### -->
<para>

</para>

@string: 
@val: 
@Returns: 


<!-- ##### FUNCTION g_string_append_c ##### -->
<para>

</para>

@string: 
@c: 
@Returns: 


<!-- ##### FUNCTION g_string_append_unichar ##### -->
<para>

</para>

@string: 
@wc: 
@Returns: 


<!-- ##### FUNCTION g_string_append_len ##### -->
<para>

</para>

@string: 
@val: 
@len: 
@Returns: 


<!-- ##### FUNCTION g_string_append_uri_escaped ##### -->
<para>

</para>

@string: 
@unescaped: 
@reserved_chars_allowed: 
@allow_utf8: 
@Returns: 


<!-- ##### FUNCTION g_string_prepend ##### -->
<para>

</para>

@string: 
@val: 
@Returns: 


<!-- ##### FUNCTION g_string_prepend_c ##### -->
<para>

</para>

@string: 
@c: 
@Returns: 


<!-- ##### FUNCTION g_string_prepend_unichar ##### -->
<para>

</para>

@string: 
@wc: 
@Returns: 


<!-- ##### FUNCTION g_string_prepend_len ##### -->
<para>

</para>

@string: 
@val: 
@len: 
@Returns: 


<!-- ##### FUNCTION g_string_insert ##### -->
<para>

</para>

@string: 
@pos: 
@val: 
@Returns: 


<!-- ##### FUNCTION g_string_insert_c ##### -->
<para>

</para>

@string: 
@pos: 
@c: 
@Returns: 


<!-- ##### FUNCTION g_string_insert_unichar ##### -->
<para>

</para>

@string: 
@pos: 
@wc: 
@Returns: 


<!-- ##### FUNCTION g_string_insert_len ##### -->
<para>

</para>

@string: 
@pos: 
@val: 
@len: 
@Returns: 


<!-- ##### FUNCTION g_string_overwrite ##### -->
<para>

</para>

@string: 
@pos: 
@val: 
@Returns: 


<!-- ##### FUNCTION g_string_overwrite_len ##### -->
<para>

</para>

@string: 
@pos: 
@val: 
@len: 
@Returns: 


<!-- ##### FUNCTION g_string_erase ##### -->
<para>

</para>

@string: 
@pos: 
@len: 
@Returns: 


<!-- ##### FUNCTION g_string_truncate ##### -->
<para>

</para>

@string: 
@len: 
@Returns: 


<!-- ##### FUNCTION g_string_set_size ##### -->
<para>

</para>

@string: 
@len: 
@Returns: 


<!-- ##### FUNCTION g_string_free ##### -->
<para>

</para>

@string: 
@free_segment: 
@Returns: 


<!-- ##### FUNCTION g_string_up ##### -->
<para>
</para>

@string: 
@Returns: 


<!-- ##### FUNCTION g_string_down ##### -->
<para>
</para>

@string: 
@Returns: 


<!-- ##### FUNCTION g_string_hash ##### -->
<para>

</para>

@str: 
@Returns: 


<!-- ##### FUNCTION g_string_equal ##### -->
<para>

</para>

@v: 
@v2: 
@Returns: 


