1 <!-- ##### SECTION Title ##### -->
4 <!-- ##### SECTION Short_Description ##### -->
5 text buffers which grow automatically as text is added
7 <!-- ##### SECTION Long_Description ##### -->
9 A #GString is similar to a standard C string, except that it grows
10 automatically as text is appended or inserted. Also, it stores the
11 length of the string, so can be used for binary data with embedded
15 <!-- ##### SECTION See_Also ##### -->
20 <!-- ##### SECTION Stability_Level ##### -->
23 <!-- ##### STRUCT GString ##### -->
25 The #GString struct contains the public fields of a #GString.
28 @str: points to the character data. It may move as text is added.
29 The <structfield>str</structfield> field is nul-terminated and so
30 can be used as an ordinary C string.
31 @len: contains the length of the string, not including the
33 @allocated_len: the number of bytes that can be stored in the
34 string before it needs to be reallocated. May be larger than @len.
36 <!-- ##### FUNCTION g_string_new ##### -->
45 <!-- ##### FUNCTION g_string_new_len ##### -->
55 <!-- ##### FUNCTION g_string_sized_new ##### -->
64 <!-- ##### FUNCTION g_string_assign ##### -->
74 <!-- ##### MACRO g_string_sprintf ##### -->
81 <!-- ##### MACRO g_string_sprintfa ##### -->
88 <!-- ##### FUNCTION g_string_vprintf ##### -->
98 <!-- ##### FUNCTION g_string_append_vprintf ##### -->
108 <!-- ##### FUNCTION g_string_printf ##### -->
118 <!-- ##### FUNCTION g_string_append_printf ##### -->
128 <!-- ##### FUNCTION g_string_append ##### -->
138 <!-- ##### FUNCTION g_string_append_c ##### -->
148 <!-- ##### FUNCTION g_string_append_unichar ##### -->
158 <!-- ##### FUNCTION g_string_append_len ##### -->
169 <!-- ##### FUNCTION g_string_append_uri_escaped ##### -->
176 @reserved_chars_allowed:
181 <!-- ##### FUNCTION g_string_prepend ##### -->
191 <!-- ##### FUNCTION g_string_prepend_c ##### -->
201 <!-- ##### FUNCTION g_string_prepend_unichar ##### -->
211 <!-- ##### FUNCTION g_string_prepend_len ##### -->
222 <!-- ##### FUNCTION g_string_insert ##### -->
233 <!-- ##### FUNCTION g_string_insert_c ##### -->
244 <!-- ##### FUNCTION g_string_insert_unichar ##### -->
255 <!-- ##### FUNCTION g_string_insert_len ##### -->
267 <!-- ##### FUNCTION g_string_overwrite ##### -->
278 <!-- ##### FUNCTION g_string_overwrite_len ##### -->
290 <!-- ##### FUNCTION g_string_erase ##### -->
301 <!-- ##### FUNCTION g_string_truncate ##### -->
311 <!-- ##### FUNCTION g_string_set_size ##### -->
321 <!-- ##### FUNCTION g_string_free ##### -->
331 <!-- ##### FUNCTION g_string_up ##### -->
339 <!-- ##### FUNCTION g_string_down ##### -->
347 <!-- ##### FUNCTION g_string_hash ##### -->
356 <!-- ##### FUNCTION g_string_equal ##### -->