Quarks

Quarks — Два способа связать строку и уникальный целочисленный идентификатор.

Краткое описание


#include <glib.h>


typedef     GQuark;
GQuark      g_quark_from_string             (const gchar *string);
GQuark      g_quark_from_static_string      (const gchar *string);
const gchar* g_quark_to_string              (GQuark quark);
GQuark      g_quark_try_string              (const gchar *string);
const gchar* g_intern_string                (const gchar *string);
const gchar* g_intern_static_string         (const gchar *string);

Описание

Кварк является связью между строками и целочисленными идентификаторами. Получая либо строку, либо GQuark идентификатор, можно найти либо то, либо другое.

Кварки используются и для Datasets и для Keyed Data Lists.

Для создания нового кварка из строки, используйте g_quark_from_string() или g_quark_from_static_string().

Для поиска строки соответствующей полученному GQuark, используйте g_quark_to_string().

Для поиска GQuark соответствующего полученной строке, используйте g_quark_try_string().

Другой способ использования для строкового пула поддерживающего функции кварка интернирования строки, использование g_intern_string() или g_intern_static_string(). Интернированная строка это канонически представленная строка. Одно важно преимущество интернированных строк в том, что они могут сравниваться на эквивалентность с помощью простого сравнения указателя, в отличие от использования strcmp().

Детали

GQuark

typedef guint32 GQuark;

GQuark это уникальный целочисленный идентификатор специфичной строки.

g_quark_from_string ()

GQuark      g_quark_from_string             (const gchar *string);

Определяет GQuark идентификатор указанной строки. Если строка не имеет текущего связанного с ней GQuark, создаётся новый GQuark, используя копию строки.

`string` :	строка.
Возвращает :	GQuark идентификатор строки.

g_quark_from_static_string ()

GQuark      g_quark_from_static_string      (const gchar *string);

Определяет GQuark идентификатор указанной (статичной) строки. Если строка не имеет связанного с ней GQuark, создаётся новый GQuark, связывая с указанной строкой.

Помните что эта функция идентична g_quark_from_string(), исключая то, что если новый GQuark создан, используется сама строка, а не её копия. Это сохраняет память, но может использоваться только если строка всегда существует. Она может использоваться со статически распределёнными строками в основной программе, но не со статически распределённой памятью в динамически загружаемых модулях, если вы планируете выгружать модуль снова (например не используйте эту функцию в движках GTK+ тем).

`string` :	строка.
Возвращает :	GQuark идентификатор строки.

g_quark_to_string ()

const gchar* g_quark_to_string              (GQuark quark);

Определяет строку связанную с полученным GQuark.

`quark` :	GQuark.
Возвращает :	строка связанная с GQuark.

g_quark_try_string ()

GQuark      g_quark_try_string              (const gchar *string);

Определяет GQuark связанный с полученной строкой, или 0 если строка не связана с GQuark.

Если вы хотите чтобы GQuark был создан, если он не существует, используйте g_quark_from_string(), или g_quark_from_static_string().

`string` :	строка.
Возвращает :	GQuark связанный со строкой, или 0, если нет GQuark связанного со строкой.

g_intern_string ()

const gchar* g_intern_string                (const gchar *string);

`string` :	строка
Возвращает :	каноническое представление строки

Начиная с версии 2.10

g_intern_static_string ()

const gchar* g_intern_static_string         (const gchar *string);

Возвращает каноническое представление string. Интернированные строки могут сравниваться на эквивалентность с помощью сравнения указателей, вместо использования strcmp(). g_intern_static_string() не копирует строку, однако string не должна освобождаться или изменяться.

`string` :	статичная строка
Возвращает :	каноническое представление строки

Начиная с версии 2.10

			Справочное описание GLib
Начало \| Описание