Описание

Наборы данных связывают группы элементов данных со специфическим расположением памяти. Это полезно если вам необходимо связать данные со структурами возвращаемыми из внешних библиотек. Так как вы не изменяете структуру, вы используете её расположение в памяти как ключ в наборе данных, в котором вы можете связать любое количество элементов данных.

Есть две формы большинства функций набора данных. Первая форма использовать строки для идентификации элементов данных связанных с расположением. Вторая форма использует идентификаторы GQuark, которые создаются с помощью вызова g_quark_from_string() или g_quark_from_static_string(). Вторая форма быстрее, так как она не требует поиска строки в хеш таблице идентификаторов GQuark.

Нет функции для создания набора данных. Он автоматически создаётся когда вы добавляете элемент в него.

Для добавления элемента в набор данных используйте g_dataset_id_set_data(), g_dataset_id_set_data_full(), g_dataset_set_data() and g_dataset_set_data_full().

Для получения элемента данных из набора данных используйте g_dataset_id_get_data() и g_dataset_get_data().

Для перемещения по всем элементам данных в наборе данных используйте g_dataset_foreach() (not thread-safe).

Для удаления элементов данных из набора данных используйте g_dataset_id_remove_data() и g_dataset_remove_data().

Для уничтожения набора данных, используйте g_dataset_destroy().

Детали

#define     g_dataset_id_set_data(l, k, d)

void        g_dataset_id_set_data_full      (gconstpointer dataset_location,
                                             GQuark key_id,
                                             gpointer data,
                                             GDestroyNotify destroy_func);

void        (*GDestroyNotify)               (gpointer data);

gpointer    g_dataset_id_get_data           (gconstpointer dataset_location,
                                             GQuark key_id);

#define     g_dataset_id_remove_data(l, k)

gpointer    g_dataset_id_remove_no_notify   (gconstpointer dataset_location,
                                             GQuark key_id);

#define     g_dataset_set_data(l, k, d)

#define     g_dataset_set_data_full(l, k, d, f)

#define     g_dataset_get_data(l, k)

#define     g_dataset_remove_data(l, k)

#define     g_dataset_remove_no_notify(l, k)

void        g_dataset_foreach               (gconstpointer dataset_location,
                                             GDataForeachFunc func,
                                             gpointer user_data);

void        (*GDataForeachFunc)             (GQuark key_id,
                                             gpointer data,
                                             gpointer user_data);

void        g_dataset_destroy               (gconstpointer dataset_location);