blob: cf435a6b6c222e740e4ac0cde1153b9c7da74eec [file] [log] [blame]
<!-- ##### SECTION Title ##### -->
Strings
<!-- ##### SECTION Short_Description ##### -->
text buffers which grow automatically as text is added
<!-- ##### SECTION Long_Description ##### -->
<para>
A #GString is similar to a standard C string, except that it grows
automatically as text is appended or inserted. Also, it stores the
length of the string, so can be used for binary data with embedded
nul bytes.
</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:
@Varargs:
<!-- ##### FUNCTION g_string_append_printf ##### -->
<para>
</para>
@string:
@format:
@Varargs:
<!-- ##### 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: