GString

typedef struct {
  gchar  *str;
  gsize len;    
  gsize allocated_len;
} GString;

Структура GString содержит общедоступные поля GString. Поле str указывает на символьные данные. Он может меняться при добавлении текста. Поле len содержит длину строки, не включая завершающий нулевой байт.

Поле str nul-завершённое и поэтому может быть использовано как обычная C string. Но она может перемещаться когда в строку добавляется или вставляется текст.

g_string_new ()

GString*    g_string_new                    (const gchar *init);

Создаёт новую GString, инициализируя полученной строкой.

g_string_new_len ()

GString*    g_string_new_len                (const gchar *init,
                                             gssize len);

Создаёт новую GString с длиной len байт буфера init. Поскольку длина обеспечена, init не должен быть nul-завершённым и может содержать встроенные nul байты.

g_string_sized_new ()

GString*    g_string_sized_new              (gsize dfl_size);

Создаёт новую GString, с достаточным пространством для dfl_size байт. Это полезно если вы добавляете много текста в строку и не хотите перераспределять её слишком часто.

g_string_assign ()

GString*    g_string_assign                 (GString *string,
                                             const gchar *rval);

Копирует байты из строки в GString, уничтожает любое предыдущее содержимое. Она скорее похожа на стандартную функцию strcpy(), за исключением того, что вам не нужно беспокоится о наличии достаточного пространства для копируемой строки.

g_string_sprintf

#define     g_string_sprintf

Записывает форматированную строку в GString. Подобна стандартной функции sprintf(), за исключением того, что буфер GString автоматически расширяется для вмещения результата. Предыдущее содержимое GString уничтожается.

g_string_sprintfa

#define     g_string_sprintfa

Добавляет форматированную строку в конец GString. Эта функция подобна g_string_sprintf(), за исключением того, что текст добавляется к GString.

g_string_printf ()

void        g_string_printf                 (GString *string,
                                             const gchar *format,
                                             ...);

Записывает форматированную строку в GString. Это подобно стандартной функции sprintf(), за исключением того, что буфер GString автоматически расширяется для вмещения результата. Предыдущее содержимое GString уничтожается.

g_string_append_printf ()

void        g_string_append_printf          (GString *string,
                                             const gchar *format,
                                             ...);

Добавляет форматированную строку в конец GString. Эта функция подобна g_string_printf(), за исключением того, что текст добавляется к GString.

g_string_append ()

GString*    g_string_append                 (GString *string,
                                             const gchar *val);

Добавляет строку в конец GString, расширяя её если необходимо.

g_string_append_c ()

GString*    g_string_append_c               (GString *string,
                                             gchar c);

Добавляет бай в конец GString, расширяя её если необходимо.

g_string_append_unichar ()

GString*    g_string_append_unichar         (GString *string,
                                             gunichar wc);

Конвертирует Unicode символ в UTF-8, и добавляет его в строку.

g_string_append_len ()

GString*    g_string_append_len             (GString *string,
                                             const gchar *val,
                                             gssize len);

Добавляет len байт val в string. Поскольку len обеспечена, val может содержать встроенные nuls и не должна быть nul-завершённой.

g_string_prepend ()

GString*    g_string_prepend                (GString *string,
                                             const gchar *val);

Добавляет строку в начало GString, расширяя её если необходимо.

g_string_prepend_c ()

GString*    g_string_prepend_c              (GString *string,
                                             gchar c);

Добавляет байт в начало GString, расширяя её если необходимо.

g_string_prepend_unichar ()

GString*    g_string_prepend_unichar        (GString *string,
                                             gunichar wc);

Конвертирует Unicode символ в UTF-8, и добавляет его в начало строки.

g_string_prepend_len ()

GString*    g_string_prepend_len            (GString *string,
                                             const gchar *val,
                                             gssize len);

Добавляет len байт val в string. Поскольку len обеспечена, val может содержать встроенные nuls и не должна быть nul-завершённой.

g_string_insert ()

GString*    g_string_insert                 (GString *string,
                                             gssize pos,
                                             const gchar *val);

Вставляет копию строки в GString, расширяя её если необходимо.

g_string_insert_c ()

GString*    g_string_insert_c               (GString *string,
                                             gssize pos,
                                             gchar c);

Вставляет байт в GString, расширяя её если необходимо.

g_string_insert_unichar ()

GString*    g_string_insert_unichar         (GString *string,
                                             gssize pos,
                                             gunichar wc);

Конвертирует Unicode символ в UTF-8, и вставляет его в строку в указанную позицию.

g_string_insert_len ()

GString*    g_string_insert_len             (GString *string,
                                             gssize pos,
                                             const gchar *val,
                                             gssize len);

Вставляет len байт val в string в позицию pos. Поскольку len обеспечена, val может содержать встроенные nuls и не должна быть nul-завершённой. Если pos это -1, байты вставляются в конец строки.

g_string_erase ()

GString*    g_string_erase                  (GString *string,
                                             gssize pos,
                                             gssize len);

Удаляет len байт из GString, сначала позиции pos. Остальная часть GString смещается вниз для заполнения пустоты.

g_string_truncate ()

GString*    g_string_truncate               (GString *string,
                                             gsize len);

Вырезает окончание GString, оставляя первые len байт.

g_string_set_size ()

GString*    g_string_set_size               (GString *string,
                                             gsize len);

Устанавливает длину GString. Если длина меньше чем текущая, строка будет обрезана. Если длина больше чем текущая, содержимое вновь добавленного пространства неопределено. (Однако, как всегда, string->str[string->len] будет nul байтом.)

g_string_free ()

gchar*      g_string_free                   (GString *string,
                                             gboolean free_segment);

Освобождает память распределённую для GString. Если free_segment это TRUE она так же освобождает символьные данные.

g_string_up ()

GString*    g_string_up                     (GString *string);

Конвертирует GString в верхний регистр.

g_string_down ()

GString*    g_string_down                   (GString *string);

Конвертирует GString в нижний регистр.

g_string_hash ()

guint       g_string_hash                   (const GString *str);

Создаёт новый хеш код для str; для использования с GHashTable.

g_string_equal ()

gboolean    g_string_equal                  (const GString *v,
                                             const GString *v2);

Сравнивает две строки на эквивалентность, возвращает TRUE если они равны. Для использования с GHashTable.