GType

GType — GLib окружение идентификации типов и система управления

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


#include <glib-object.h>


typedef             GType;
#define             G_TYPE_FUNDAMENTAL                  (type)
#define             G_TYPE_FUNDAMENTAL_MAX
#define             G_TYPE_MAKE_FUNDAMENTAL             (x)
#define             G_TYPE_IS_ABSTRACT                  (type)
#define             G_TYPE_IS_DERIVED                   (type)
#define             G_TYPE_IS_FUNDAMENTAL               (type)
#define             G_TYPE_IS_VALUE_TYPE                (type)
#define             G_TYPE_HAS_VALUE_TABLE              (type)
#define             G_TYPE_IS_CLASSED                   (type)
#define             G_TYPE_IS_INSTANTIATABLE            (type)
#define             G_TYPE_IS_DERIVABLE                 (type)
#define             G_TYPE_IS_DEEP_DERIVABLE            (type)
#define             G_TYPE_IS_INTERFACE                 (type)
                    GTypeInterface;
                    GTypeInstance;
                    GTypeClass;
                    GTypeInfo;
                    GTypeFundamentalInfo;
                    GInterfaceInfo;
                    GTypeValueTable;
#define             G_TYPE_FROM_INSTANCE                (instance)
#define             G_TYPE_FROM_CLASS                   (g_class)
#define             G_TYPE_FROM_INTERFACE               (g_iface)
#define             G_TYPE_INSTANCE_GET_CLASS           (instance, g_type, c_type)
#define             G_TYPE_INSTANCE_GET_INTERFACE       (instance, g_type, c_type)
#define             G_TYPE_INSTANCE_GET_PRIVATE         (instance, g_type, c_type)
#define             G_TYPE_CHECK_INSTANCE               (instance)
#define             G_TYPE_CHECK_INSTANCE_CAST          (instance, g_type, c_type)
#define             G_TYPE_CHECK_INSTANCE_TYPE          (instance, g_type)
#define             G_TYPE_CHECK_CLASS_CAST             (g_class, g_type, c_type)
#define             G_TYPE_CHECK_CLASS_TYPE             (g_class, g_type)
#define             G_TYPE_CHECK_VALUE                  (value)
#define             G_TYPE_CHECK_VALUE_TYPE             (value, g_type)
#define             G_TYPE_FLAG_RESERVED_ID_BIT
void                g_type_init                         (void);
enum                GTypeDebugFlags;
void                g_type_init_with_debug_flags        (GTypeDebugFlags debug_flags);
const gchar*        g_type_name                         (GType type);
GQuark              g_type_qname                        (GType type);
GType               g_type_from_name                    (const gchar *name);
GType               g_type_parent                       (GType type);
guint               g_type_depth                        (GType type);
GType               g_type_next_base                    (GType leaf_type,
                                                         GType root_type);
gboolean            g_type_is_a                         (GType type,
                                                         GType is_a_type);
gpointer            g_type_class_ref                    (GType type);
gpointer            g_type_class_peek                   (GType type);
gpointer            g_type_class_peek_static            (GType type);
void                g_type_class_unref                  (gpointer g_class);
gpointer            g_type_class_peek_parent            (gpointer g_class);
void                g_type_class_add_private            (gpointer g_class,
                                                         gsize private_size);
gpointer            g_type_interface_peek               (gpointer instance_class,
                                                         GType iface_type);
gpointer            g_type_interface_peek_parent        (gpointer g_iface);
gpointer            g_type_default_interface_ref        (GType g_type);
gpointer            g_type_default_interface_peek       (GType g_type);
void                g_type_default_interface_unref      (gpointer g_iface);
GType*              g_type_children                     (GType type,
                                                         guint *n_children);
GType*              g_type_interfaces                   (GType type,
                                                         guint *n_interfaces);
GType*              g_type_interface_prerequisites      (GType interface_type,
                                                         guint *n_prerequisites);
void                g_type_set_qdata                    (GType type,
                                                         GQuark quark,
                                                         gpointer data);
gpointer            g_type_get_qdata                    (GType type,
                                                         GQuark quark);
void                g_type_query                        (GType type,
                                                         GTypeQuery *query);
                    GTypeQuery;
void                (*GBaseInitFunc)                    (gpointer g_class);
void                (*GBaseFinalizeFunc)                (gpointer g_class);
void                (*GClassInitFunc)                   (gpointer g_class,
                                                         gpointer class_data);
void                (*GClassFinalizeFunc)               (gpointer g_class,
                                                         gpointer class_data);
void                (*GInstanceInitFunc)                (GTypeInstance *instance,
                                                         gpointer g_class);
void                (*GInterfaceInitFunc)               (gpointer g_iface,
                                                         gpointer iface_data);
void                (*GInterfaceFinalizeFunc)           (gpointer g_iface,
                                                         gpointer iface_data);
gboolean            (*GTypeClassCacheFunc)              (gpointer cache_data,
                                                         GTypeClass *g_class);
enum                GTypeFlags;
enum                GTypeFundamentalFlags;
GType               g_type_register_static              (GType parent_type,
                                                         const gchar *type_name,
                                                         const GTypeInfo *info,
                                                         GTypeFlags flags);
GType               g_type_register_static_simple       (GType parent_type,
                                                         const gchar *type_name,
                                                         guint class_size,
                                                         GClassInitFunc class_init,
                                                         guint instance_size,
                                                         GInstanceInitFunc instance_init,
                                                         GTypeFlags flags);
GType               g_type_register_dynamic             (GType parent_type,
                                                         const gchar *type_name,
                                                         GTypePlugin *plugin,
                                                         GTypeFlags flags);
GType               g_type_register_fundamental         (GType type_id,
                                                         const gchar *type_name,
                                                         const GTypeInfo *info,
                                                         const GTypeFundamentalInfo *finfo,
                                                         GTypeFlags flags);
void                g_type_add_interface_static         (GType instance_type,
                                                         GType interface_type,
                                                         const GInterfaceInfo *info);
void                g_type_add_interface_dynamic        (GType instance_type,
                                                         GType interface_type,
                                                         GTypePlugin *plugin);
void                g_type_interface_add_prerequisite   (GType interface_type,
                                                         GType prerequisite_type);
GTypePlugin*        g_type_get_plugin                   (GType type);
GTypePlugin*        g_type_interface_get_plugin         (GType instance_type,
                                                         GType interface_type);
GType               g_type_fundamental_next             (void);
GType               g_type_fundamental                  (GType type_id);
GTypeInstance*      g_type_create_instance              (GType type);
void                g_type_free_instance                (GTypeInstance *instance);
void                g_type_add_class_cache_func         (gpointer cache_data,
                                                         GTypeClassCacheFunc cache_func);
void                g_type_remove_class_cache_func      (gpointer cache_data,
                                                         GTypeClassCacheFunc cache_func);
void                g_type_class_unref_uncached         (gpointer g_class);
void                g_type_add_interface_check          (gpointer check_data,
                                                         GTypeInterfaceCheckFunc check_func);
void                g_type_remove_interface_check       (gpointer check_data,
                                                         GTypeInterfaceCheckFunc check_func);
void                (*GTypeInterfaceCheckFunc)          (gpointer check_data,
                                                         gpointer g_iface);
GTypeValueTable*    g_type_value_table_peek             (GType type);
#define             G_DEFINE_TYPE                       (TN, t_n, T_P)
#define             G_DEFINE_TYPE_WITH_CODE             (TN, t_n, T_P, _C_)
#define             G_DEFINE_ABSTRACT_TYPE              (TN, t_n, T_P)
#define             G_DEFINE_ABSTRACT_TYPE_WITH_CODE    (TN, t_n, T_P, _C_)
#define             G_IMPLEMENT_INTERFACE               (TYPE_IFACE, iface_init)
#define             G_DEFINE_TYPE_EXTENDED              (TN, t_n, T_P, _f_, _C_)


#define             G_TYPE_INVALID
#define             G_TYPE_NONE
#define             G_TYPE_INTERFACE
#define             G_TYPE_CHAR
#define             G_TYPE_UCHAR
#define             G_TYPE_BOOLEAN
#define             G_TYPE_INT
#define             G_TYPE_UINT
#define             G_TYPE_LONG
#define             G_TYPE_ULONG
#define             G_TYPE_INT64
#define             G_TYPE_UINT64
#define             G_TYPE_ENUM
#define             G_TYPE_FLAGS
#define             G_TYPE_FLOAT
#define             G_TYPE_DOUBLE
#define             G_TYPE_STRING
#define             G_TYPE_POINTER
#define             G_TYPE_BOXED
#define             G_TYPE_PARAM
#define             G_TYPE_OBJECT
#define             G_TYPE_GTYPE

#define             G_TYPE_RESERVED_GLIB_FIRST
#define             G_TYPE_RESERVED_GLIB_LAST
#define             G_TYPE_RESERVED_BSE_FIRST
#define             G_TYPE_RESERVED_BSE_LAST
#define             G_TYPE_RESERVED_USER_FIRST

Описание

GType API является основой системы GObject. Он обеспечивает средства для регистрации и управления всеми базовыми типами данных, определённых пользователем объектов и типами интерфейсов. Перед использованием любых функций GType или GObject, должна быть вызвана g_type_init() для инициализации системы типов.

Для создания типа и регистрационных целей, все типы относятся к одной из двух категорий: статические или динамические. Статические типы никогда не загружаются и не выгружаются во время выполнения, как это могут делать динамические типы. Статические типы создаются с помощью g_type_register_static() которая получает определённую информацию помещаемую в неё через структуру GTypeInfo. Динамические типы создаются с помощью g_type_register_dynamic() которая принимает вместо сструктуры GTypePlugin. Оставшаяся информация типа (GTypeInfo структура) находится во время выполнения через GTypePlugin и g_type_plugin_*() API. Эти регистрационные функции полезно вызывать только однажды из функции целью которой является возврат идентификатора типа для определённого класса. Как только тип (либо класс или интерфейс) зарегистрирован, он может быть инстанциирован, унаследован, или реализован в зависимости от того, что это за тип. Есть также третья регистрационная функция для регистрации базовых типовg_type_register_fundamental() которая требует и структуру GTypeInfo и структуру GTypeFundamentalInfo, но она редко используется, так как большинство базовых типов является предопределёнными и не определяются пользователем.

В заключительном слове об именах типов. Такой идентификатор должен быть по крайней мере длиной из трёх символов. Максимального предела длины не существует. Первый символ должен быть буквой (a-z или A-Z) или символом подчёркивания '_'. Последующие символы могут быть буквами, цифрами или одним из символов '-_+'.

Детали

GType

Числовое значение которое представляет уникальный идентификатор зарегистрированного типа.

G_TYPE_FUNDAMENTAL()

Возвращает базовый тип который наследует type. Базовые типы являются типами которые служат основой для производных типов, таким образом они являются корнями отдельных иерархий наследования.

type :

GType значение.

G_TYPE_FUNDAMENTAL_MAX

Целочисленная константа представляющая количество идентификаторов, зарезервированных для типов обозначенных во время компиляции.

G_TYPE_MAKE_FUNDAMENTAL()

Возвращает ID для базового типа с номером x. Используйте g_type_fundamental_next() вместо этого макроса для создания нового базового типа.

x :

номер базового типа.

G_TYPE_IS_ABSTRACT()

Возвращает TRUE если type является абстрактным. Абстрактный тип может не инициироваться и используется обычно как абстрактный основной класс для наследования классов.

type :

значение GType.

G_TYPE_IS_DERIVED()

Возвращает TRUE если type унаследован из другого типа (возвращает TRUE для всех не базовых типов).

type :

значение GType.

G_TYPE_IS_FUNDAMENTAL()

Возвращает TRUE если type является базовым типом.

type :

значение GType.

G_TYPE_IS_VALUE_TYPE()

Возвращает TRUE если type является типовым значением и может использоваться с помощью g_value_init().

type :

значение GType.

G_TYPE_HAS_VALUE_TABLE()

Возвращает TRUE если type имеет GTypeValueTable.

type :

значение GType.

G_TYPE_IS_CLASSED()

Возвращает TRUE если type является классовым типом.

type :

значение GType.

G_TYPE_IS_INSTANTIATABLE()

Возвращает TRUE если type может быть инстанциирован. Инстанциация - это процесс создания экземпляра объекта данного типа.

type :

значение GType.

G_TYPE_IS_DERIVABLE()

Возвращает TRUE если type является наследником. Наследуемый тип может использоваться как основной класс плоской (одноуровневой) иерархии класса.

type :

значение GType.

G_TYPE_IS_DEEP_DERIVABLE()

Возвращает TRUE если type глубоко наследуемыйй тип. Глубоко наследуемыйй тип может использоваться как основной класс глубокой (многоуровневой) иерархии класса.

type :

значение GType.

G_TYPE_IS_INTERFACE()

Возвращает TRUE если type является интерфейсным типом. Интерфейсные типы обеспечивают чистый API, реализация которого обеспечивается другим типом (который, как говорится в таких случаях, соответствует интерфейсу). GLib интерфейсы являются в некотором роде аналогами интерфейсов Java и C++ классов содержащие только чистые виртуальные функции, различие в том, что GType интерфейсы не наследуемый (но можно посмотреть альтернативу g_type_interface_add_prerequisite()).

type :

значение GType.

GTypeInterface

Непрозрачная структура используемая как основа всех интерфейсных типов.

GTypeInstance

Непрозрачная структура используемая как основа всех инстанциируемых типов.

GTypeClass

Непрозрачная структура используемая как основа всех классов.

GTypeInfo

Эта структура используется для обеспечения системы типов информацией запрашиваемой для инициализации и уничтожения (финализации) типового класса и его экземпляра. Инициализированная структура помещается в функцию g_type_register_static() (или копируется в структуру GTypeInfo обеспеченную функциейg_type_plugin_complete_type_info()). Система типов выполнит глубокую копию этой сструктуры, поэтому память не должна быть постоянной через вызовg_type_register_static().

guint16 class_size;

Размер сструктуры класса (требуется для интерфейсных, классифицированных и инстанцируемых типов).

GBaseInitFunc base_init;

Расположение основной инициализирующей функции (опционально).

GBaseFinalizeFunc base_finalize;

Расположение основной финализирующей функции (опционально).

GClassInitFunc class_init;

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

GClassFinalizeFunc class_finalize;

Расположение функции финализации класса для классов и типов. Расположение по умолчанию в vtable функции финализации интерфейсных типов. (опционально)

gconstpointer class_data;

Данные обеспечиваемые пользователем помещаемые в классовые функции инициализация/финализация.

guint16 instance_size;

Размер экземпляра (объекта) сструктуры (запрашиваемый только для инстанциирования).

guint16 n_preallocs;

До GLib 2.10, представлял количество предварительно распределённых (кэшированных) экземпляров для резервирования памяти (0 указывает на отсутствие кэша). Начиная с версии GLib 2.10, игнорируется, так как теперь экземпляры распределяются с помощью slice allocator.

GInstanceInitFunc instance_init;

Расположение функции инициализирующей экземпляр (опционально, только для инстанциируемых типов).

const GTypeValueTable *value_table;

Табличная функция GTypeValueTable для основной обработки GValues этого типа (обычно полезна только для базовых типов).

GTypeFundamentalInfo

Структура обеспечивающая информацией систему типов специально для управления базовыми типами.

GTypeFundamentalFlags type_flags;

GTypeFundamentalFlags описывает характеристики базового типа

GInterfaceInfo

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

GInterfaceInitFunc interface_init;

расположение функции инициализации интерфейса

GInterfaceFinalizeFunc interface_finalize;

расположение функции финализации интерфейса

gpointer interface_data;

пользовательские данные для функций инициализации/финализации интерфейса

GTypeValueTable

GTypeValueTable обеспечивает функции требуемые реализацией GValue, которая служит контейнером для значений типа.

value_init ()

По умолчанию инициализирует содержимое values записывая значения непосредственно в массив value->data. Массив данных GValue помещённый в эту функцию будет заполнен нулями с помощью memset(), поэтому не нужно беспокоится об освобождении предыдущего содержимого. Например реализация строкового значения которое могло бы быть не NULL, может выглядеть так:

value_free ()

Освобождает любое предыдущее содержимое массива данных помещённого в value. Ресурсы распределённые для содержимого GValue после вызова этой функции освобождаются. На примере нашей строки выше:

value_copy ()

dest_value это GValue с разделом данных заполненным нулями, а src_value надлежащим образом установленная GValue того же или производного типа. Цель функции заключается в копировании содержимого src_value в dest_value, то есть даже после освобождения src_value, содержимое dest_value останется доступным. Типовой пример строки:

value_peek_pointer ()

Если значение содержимого заполнено указателем, таким как объекты или строки, возвращает этот указатель, таким образом вызывающая программа может посмотреть текущее содержимое. Расширение нашего примера строки выше:

gchar *collect_format;

Формат строки описывающий как накапливается содержимое этого значения поразрядно. Каждый символ в формате представляет накапливаемый параметр и непосредственно символы указывают тип параметра. В настоящее время поддерживаются параметры:

Должно быть отмечено, что для конструирования списка переменных параметров, ANSI C преобразует каждый тип меньше чем целочисленное в int, а floats в doubles. Поэтому для накапливания short int или char, нужно использовать 'i', а для накапливания floats 'd'.

collect_value ()

функция collect_value() отвечает за преобразование накопленных значений из списка переменных параметров в содержимое подходящее для хранения в GValue. Эта функция должна установить value подобно value_init(); например для строкового значения которое не допускает NULL указателей, она должна либо вернуть ошибку, либо выполнить неявное преобразование сохранив пустую строку. value помещённый в эту функцию является нулевым массивом данных, таким образом точно так же как для value_init() гарантирует отсутствие предыдущего содержимого которое нужно освобождать. n_collect_values точная длина строкиcollect_format, а collect_values массив объединений GTypeCValue с длиной n_collect_values, содержащий накопленные значения согласноcollect_format. collect_flags - является параметром обеспечивающим подсказку для вызывающей программы. Он может содержать флаг G_VALUE_NOCOPY_CONTENTS указывающий, что накопленное значение содержимого можно рассматривать как "static" в течение жизненного цикла value. Поэтому дополнительная копия содержимого сохранённого в collect_values не требуется для назначения value. Наш пример строки выше, мы продолжим следующим:

Должно быть отмечено, что это вообще плохая идея следовать подсказке G_VALUE_NOCOPY_CONTENTS для подсчёта типовых ссылок. Из-за повторно используемого запроса и условия подсчёта ссылок с помощью кода GSignal, подсчёт ссылок должен всегда увеличиваться подсчёта ссылок содержимого хранящегося в массиве value->data. На мгновение отклонимся от нашего примера строки, и рассмотрим экземпляр реализации для collect_value() с ""

Подсчёт ссылок для допустимых объектов всегда увеличивается, независимо от collect_flags. Для недопустимых объектов, пример возвращает вновь распределённую строку без изменения value. После успешного выполнения, collect_value() должен вернуть NULL. Однако если произошла ошибка, collect_value() может выдать ошибку возвращая вновь распределённую не-NULL строку, дав подходящее описание произошедшей ошибки. Вызываемый код не пытается определить допустимость содержимого value при возвращении ошибки, value просто выбрасывается без дальнейшего освобождения. Так же, это хороший метод не распределять содержимое GValue, до возвращения ошибки, однако, collect_values() не обязана возвращать правильно установленное value для возврата ошибки, просто потому что любое не-NULL возвращение рассматривается как фатальное условие поэтому дальнейшее поведение программы не определено.

gchar *lcopy_format;

Формат описывающий аргументы накопленные для lcopy_value, аналогичен collect_format. Обычно, строка lcopy_format состоит только из 'p' для обеспеченияlcopy_value() указателями на сохраняемые расположения.

lcopy_value ()

Эта функция отвечает за сохранение содержимого value в параметрах помещаемых через список переменных параметров которые накоплены в collect_valuesсогласно lcopy_format. n_collect_values равен длине строки lcopy_format, а collect_flags может содержать G_VALUE_NOCOPY_CONTENTS. В отличие от collect_value(), lcopy_value() обязан всегда должным образом поддерживать G_VALUE_NOCOPY_CONTENTS. Подобно collect_value() функция может прерываться преждевременно возвращая вновь распределённую строку описывающую произошедшую ошибку. Завершаем пример строки:

И демонстрационная версия lcopy_value() для подсчёта ссылок типов:

G_TYPE_FROM_INSTANCE()

Возвращает идентификатор типа из полученной сструктуры instance.

Этот макрос должен использоваться только при реализации типа.

instance :

Расположение допустимой сструктуры GTypeInstance.

G_TYPE_FROM_CLASS()

Возвращает идентификатор из полученной сструктуры class.

Этот макрос должен использоваться только при реализации типа.

g_class :

Расположение допустимой сструктуры GTypeClass.

G_TYPE_FROM_INTERFACE()

Возвращает идентификатор из полученной сструктуры interface.

Этот макрос должен использоваться только при реализации типа.

g_iface :

Расположение допустимой сструктуры GTypeInterface.

G_TYPE_INSTANCE_GET_CLASS()

Возвращает структуру класса полученного instance, приводя к указанному типу предка экземпляра g_type.

Внимание

Помните что в течение вызова GInstanceInitFunc(), указатель класса изменяется, поэтому может не всегда возвращаться ожидаемый указатель.

Этот макрос должен использоваться только при реализации типа.

instance :

Расположение сструктуры GTypeInstance.

g_type :

Тип возвращаемого родительского класса.

c_type :

C тип соответствующий g_type.

G_TYPE_INSTANCE_GET_INTERFACE()

Возвращает структуру интерфейса для интерфейса g_type полученного instance.

Этот макрос должен использоваться только для реализации типа.

instance :

Расположение сструктуры GTypeInstance.

g_type :

Возвращаемые интерфейсный тип.

c_type :

C тип соответствующий g_type.

G_TYPE_INSTANCE_GET_PRIVATE()

Выдаёт закрытую структуру для определённого типа. Закрытая структура должна быть зарегистрирована в функции class_init с помощью g_type_class_add_private().

Этот макрос должен использоваться только при реализации типа.

instance :

экземпляр типа наследующий private_type.

g_type :

идентификатор типа который определяется с помощью закрытых данных.

c_type :

C тип для закрытой сструктуры.

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

G_TYPE_CHECK_INSTANCE()

Возвращает TRUE если instance является допустимой структурой GTypeInstance, иначе издаёт предупреждение и возвращает FALSE.

Этот макрос должен использоваться только при реализации типа.

instance :

Расположение сструктуры GTypeInstance.

G_TYPE_CHECK_INSTANCE_CAST()

Проверяет является ли instance экземпляром типа идентифицируемым g_type и издаёт предупреждение если это не так. Возвращает instance приведённый к указателю c_type.

Этот макрос должен использоваться только при реализации типа.

instance :

Расположение сструктуры GTypeInstance.

g_type :

возвращаемый тип.

c_type :

C тип соответствующий g_type.

G_TYPE_CHECK_INSTANCE_TYPE()

Возвращает TRUE если instance является экземпляром типа идентифицируемым g_type. Иначе издаёт предупреждение и возвращает FALSE.

Этот макрос должен использоваться только при реализации типа.

instance :

Расположение сструктуры GTypeInstance.

g_type :

Проверяемый тип

G_TYPE_CHECK_CLASS_CAST()

Проверяет является ли g_class классовой структурой типа идентифицируемого g_type и издаёт предупреждение если это не так. Возвращает g_class приведённый к указателю c_type.

Этот макрос должен использоваться только при реализации типа.

g_class :

Расположение сструктуры GTypeClass.

g_type :

Возвращаемый тип.

c_type :

C тип соответствующий g_type.

G_TYPE_CHECK_CLASS_TYPE()

Возвращает TRUE если g_class является классовой структурой типа идентифицируемого с помощью g_type. Иначе издаёт предупреждение и возвращает FALSE.

Этот макрос должен использоваться только при реализации типа.

g_class :

Расположение сструктуры GTypeClass.

g_type :

Проверяемый тип.

G_TYPE_CHECK_VALUE()

Возвращает TRUE если value инициализировано типовым значением.

Этот макрос должен использоваться только при реализации типа.

value :

GValue

G_TYPE_CHECK_VALUE_TYPE()

Возвращает TRUE если value инициализировано значением типа g_type.

Этот макрос должен использоваться только при реализации типа.

value :

GValue

g_type :

Проверяемый тип.

G_TYPE_FLAG_RESERVED_ID_BIT

Бит в числе типа который должен быть нетронутым.

g_type_init ()

Перед любым использованием системы типов, вызывается g_type_init() для инициализации системы типов и сортировки других частей кода (таких как различные реализации базовых типов или системы сигналов).

Перечисление GTypeDebugFlags

Перечисление значений GTypeDebugFlags может помещаться в g_type_init_with_debug_flags() для переключения отладочных сообщений в процессе выполнения. Помните что сообщения могут также переключаться с помощью установки переменной окружения GOBJECT_DEBUG в список разделённых между собой символом ':' "objects" и "signals".

G_TYPE_DEBUG_NONE

Не печатать сообщение.

G_TYPE_DEBUG_OBJECTS

Напечатать сообщение об подсчёте объекта.

G_TYPE_DEBUG_SIGNALS

Напечатать сообщение об эмиссии сигнала.

G_TYPE_DEBUG_MASK

Маска покрывающая все отладочные флаги.

g_type_init_with_debug_flags ()

Подобна g_type_init(), но дополнительно устанавливает отладочные флаги.

debug_flags :

Поразрядная комбинация значений GTypeDebugFlags для отладки.

g_type_name ()

Возвращает уникальное имя которое назначено типу ID (это привилегированный метод определения был ли определённый тип зарегистрирован для помещённого ID).

type :

Тип для которого возвращается имя.

Возвращает :

Статичное имя типа или NULL.

g_type_qname ()

Возвращает соответствующий кварк названия типа ID.

type :

тип для которого возвращается кварк.

Возвращает :

Кварк имени типа или 0.

g_type_from_name ()

Находит типовой ID из полученного имени типа, возвращает 0 если нет зарегистрированного типа с данным именем (это привилегированный метод определения по имени был ли зарегистрирован тип).

name :

Имя типа для поиска.

Возвращает :

Соответствующий типу ID или 0.

g_type_parent ()

Возвращает прямого родителя типа переданного в типе. Если тип не имеет помещённого в него родителя, то есть это базовый тип, возвращается 0.

type :

Производный тип.

Возвращает :

Родительский тип.

g_type_depth ()

Возвращает длину родословной помещенной в тип. Это включает сам тип непосредственно, поэтому базовые типы имеют глубину 1.

type :

значение GType.

Возвращает :

Глубина родословной type.

g_type_next_base ()

Получает leaf_type и root_type который содержится в его родителе, возвращает тип непосредственно родителя root_type. Другими словами, эта функция определяет тип который получен непосредственно из root_type, который является также базовым классом leaf_type. Учитывая корневой тип и тип ответвления, эта функция может использоваться для определения типов и порядка в котором тип ответвления появляется из корневого типа.

leaf_type :

Потомок root_type и возвращаемый тип.

root_type :

Непосредственный родитель возвращаемого типа.

Возвращает :

Непосредственный ребёнок root_type и родитель leaf_type.

g_type_is_a ()

Если is_a_type является производным типом, проверяет является ли type потомком is_a_type. Если is_a_type является интерфейсом, проверяет соответствует ли он type.

type :

Тип для проверки родословной.

is_a_type :

Возможный родитель type или интерфейс соответствующий type.

Возвращает :

TRUE если type содержит is_a_type.

g_type_class_ref ()

Увеличивает количество ссылок классовой сструктуры принадлежащей type. Эта функция создаст запрашиваемый класс если он ещё не существует.

type :

Типовой ID классифицируемого типа.

Возвращает :

Структуру GTypeClass для полученного типового ID.

g_type_class_peek ()

Эта функция такая же как g_type_class_ref(), только количество ссылок уменьшается. Как следствие, эта функция может вернуть NULL если помещённый в неё классовый тип в данный момент не существует (не имеет ссылок).

type :

Типовой ID классифицируемого типа.

Возвращает :

Структура GTypeClass для полученного типового ID или NULL если класс в данный момент не существует.

g_type_class_peek_static ()

Более эффективная версия g_type_class_peek() которая работает только для статических типов.

type :

Типовой ID классифицируемого типа.

Возвращает :

Структура GTypeClass для полученного типового ID или NULL если класс не существует в данный момент или загружается динамически.

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

g_type_class_unref ()

Уменьшает количество ссылок помещённой сструктуры класса. Как только последняя ссылка была освобождена, класс может финализироваться системой типов, поэтому дальнейшее разыменование указателя класса после g_type_class_unref() невозможно.

g_class :

Структура GTypeClass для сброса ссылки.

g_type_class_peek_parent ()

Эта удобная функция часто необходима при инициализации класса. Она возвращает структуру класса непосредственно родительского типа помещенного класса. Так как производные классы содержат количество ссылок их родительских классов пока они инстанциирубтся, возвращаемый класс будет всегда существовать. Эта функция очень похожа на:

g_class :

Структура GTypeClass для определения родительского класса.

Возвращает :

Родительский класс g_class.

g_type_class_add_private ()

Регистрирует закрытую структуру для инстанциируемого типа; когда объект распределён, закрытая структура типа и все родительские типы распределяются последовательно в тот же блок памяти что и общие сструктуры. Эта функция должна вызываться в типовой функции class_init(). Закрытая структура может быть найдена используя макросG_TYPE_INSTANCE_GET_PRIVATE(). В следующем примере показано прикрепление закрытой сструктуры MyObjectPrivate к объекту MyObject определённому в стандартном стиле GObject.

g_class :

классовая структура для инстанциируемого типа

private_size :

размер закрытой сструктуры.

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

g_type_interface_peek ()

Возвращает структуру GTypeInterface интерфейса которому соответствует помещённый класс.

instance_class :

Структура GTypeClass.

iface_type :

ID интерфейса которому соответствует этот класс.

Возвращает :

Структуру GTypeInterface интерфейса iface_type если реализован с помощью instance_class, иначе NULL.

g_type_interface_peek_parent ()

Возвращает структуру GTypeInterface соответствующего родительского типа типового экземпляра которому принадлежит g_iface. Это полезно когда наследуется реализация интерфейса из родительского типа и возможно отменяются некоторые методы.

g_iface :

Структура GTypeInterface.

Возвращает :

Соответствующую структуру GTypeInterface родительского типа типового экземпляра к которому принадлежит g_iface, или NULL если родительский тип не соответствует интерфейсу.

g_type_default_interface_ref ()

Увеличивает количество ссылок для интерфейсного типа g_type, и возвращает значение по умолчанию интерфейс vtable для типа.

Если тип в текущий момент не используется, то значение по умолчанию vtable для типа будет создано и инициализировано вызовом инициализации основного типа и функций инициализации значения по умолчанию vtable для типа (@base_init и class_init члены GTypeInfo). Вызов g_type_default_interface_ref() полезен когда вам нужно убедиться что сигналы и свойства для интерфейса были установлены.

g_type :

интерфейсный тип

Возвращает :

значение по умолчанию vtable для интерфейса; вызовите g_type_default_interface_unref() после использования интерфейса.

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

g_type_default_interface_peek ()

Если интерфейсный тип g_type в текущий момент используется, возвращает значение по умолчанию vtable интерфейса.

g_type :

интерфейсный тип

Возвращает :

значение по умолчанию vtable для интерфейса, или NULL если тип в текущий момент не используется.

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

g_type_default_interface_unref ()

Уменьшает количество ссылок для типа соответствующего значению по умолчанию vtable интерфейса g_iface. Если тип динамический, то когда ни кто не использует интерфейс и все ссылки сброшены, будет вызвана функция финализации для значения по умолчанию vtable интерфейса (class_finalize член GTypeInfo).

g_iface :

значение по умолчанию сструктуры vtable для интерфейса, которую возвращает g_type_default_interface_ref()

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

g_type_children ()

Возвращает вновь распределенный и 0-завершённый массив типа ID, записывая в список дочерние типы type. Возвращаемое значение должно быть освобождено с помощьюg_free() после использования.

type :

Родительский тип.

n_children :

Опционально guint указатель на содержащий количество дочерних типов.

Возвращает :

Вновь распределённый и 0-завершённый массив дочерних типов.

g_type_interfaces ()

Возвращает вновь распределённый и 0-завершённый массив типа ID, записывая в список интерфейсные типы которым соответствует этот type. Возвращаемое значение должно быть освобождено с помощью g_free() после использования.

type :

Тип для списка интерфейсных типов.

n_interfaces :

Опционально guint указатель содержащий количество интерфейсных типов.

Возвращает :

Вновь распределённый и 0-завершённый массив интерфейсных типов.

g_type_interface_prerequisites ()

Возвращает предпосылки интерфейсного типа.

interface_type :

тип интерфейса

n_prerequisites :

расположение для возвращаемого количества предпосылок, или NULL

Возвращает :

вновь распределённый 0-завершённый массив GType содержащий предпосылки interface_type

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

g_type_set_qdata ()

Прикрепляет произвольные данные к типу.

type :

GType

quark :

GQuark для идентификации данных

data :

данные

g_type_get_qdata ()

Возвращает данные предварительно прикреплённые к type с помощью g_type_set_qdata().

type :

GType

quark :

GQuark для идентификации данных

Возвращает :

данные, или NULL если данные не найдены

g_type_query ()

Запрашивает у системы типов информацию об определённом типе. Эта функция заполняет определённую пользователем структуру типовой информацией. Если помещен неверный GType, type член GTypeQuery равен 0. Все члены заполненные в структуре GTypeQuery должны рассматриваться как константы и не должны изменяться.

type :

GType значение статичного, классифицированного типа.

query :

Обеспеченная пользователем структура которая заполняется константными значениями в случае успешного выполнения.

GTypeQuery

Структура содержащая информацию для определённого типа. Она заполняется функцией g_type_query().

GType type;

GType значение типа.

const gchar * type_name;

имя типа.

guint class_size;

размер сструктуры класса.

guint instance_size;

размер сструктуры экземпляра.

GBaseInitFunc ()

Это callback-функция используемая системой типов для основной инициализации классовых структур производных типов. Она вызывается как часть процесса инициализации всех производных классов и должна перераспределить или сбросить все динамические члены класса скопированные из родительского класса. Например, члены класса (такие как строки) которые не достаточно обработать простым копированием памяти родительского класса в производный класс, должны быть изменены. Смотрите GClassInitFunc() для обсуждения процесса инициализации классов.

g_class :

Структура GTypeClass для инициализации.

GBaseFinalizeFunc ()

Это callback-функция используемая системой типов для финализации тех частей сструктуры класса производного типа которые были установлены из соответствующей функцииGBaseInitFunc(). Финализация класса в основном работает в обратном порядке относительно процесса инициализации класса. Смотрите GClassInitFunc() для обсуждения процесса инициализации класса.

g_class :

Структура GTypeClass для финализации.

GClassInitFunc ()

Это callback-функция используемая системой типов для инициализации класса определённого типа. Она должна инициализировать все статичные члены класса. Процесс инициализации класса включает:

1 - Копирование основных членов из родительского класса в структуру класса наследника.

2 - Инициализация нулём оставшихся членов не скопированных из родительского класса.

3 - Запрос GBaseInitFunc() инициализируя весь родительский тип и классовый тип.

4 - Запрос инициализатора класса GClassInitFunc().

Так как производные классы частично инициализируются через копирование памяти родительского класса, основное правило в том, что GBaseInitFunc() и GBaseFinalizeFunc()должны заботится о необходимой переинициализации и высвобождении тех членов класса которые были введены типом определившим эти GBaseInitFunc()/GBaseFinalizeFunc().GClassInitFunc() должна заботиться только об инициализации статичных членов класса, в то время как динамические члены класса (такие как распределённые строки или ресурсы подсчёта ссылок) лучше обрабатывать с помощью GBaseInitFunc() для данного типа, таким образом надлежащая инициализация динамических членов класса также выполняется для инициализации классов производных типов. Пример может помочь понять предназначение разных инициализаторов класса:

Инициализация TypeBClass сначала вызовет инициализацию TypeAClass (производные классы ссылаются на их родительские классы, смотрите g_type_class_ref()). Инициализация TypeAClass инициализирует нулями свои поля, зтем вызовет свою GBaseInitFunc() type_a_base_class_init() для распределения своих динамических членов (dynamic_string), и наконец вызовет свою GClassInitFunc() type_a_class_init() для инициализации статических членов (static_integer). Первым шагом в процессе инициализации TypeBClass является прямое копирование памяти содержащей TypeAClass в TypeBClass и инициализация нулями оставшихся полей в TypeBClass. Динамические члены TypeAClass внутри TypeBClass теперь необходимо переинициализировать выполнив вызов type_a_base_class_init() с параметром TypeBClass. После GBaseInitFunc() из TypeBClass, вызывается type_b_base_class_init() для распределения динамических членов TypeBClass (dynamic_gstring), и наконец GClassInitFunc() из TypeBClass, вызывается type_b_class_init() для завершения процесса инициализации со статическими членами (static_float). Соответствующее количество частей финализации для GBaseInitFunc()функций обеспечивают освобождение распределённых ресурсов во время финализации класса.

g_class :

Структура GTypeClass для инициализации.

class_data :

Член class_data поставляемый через структуру GTypeInfo.

GClassFinalizeFunc ()

Это callback-функция используемая системой типов для финализации класса. Она редко нужна, так как динамически распределяемые ресурсы классов должны обрабатываться с помощью GBaseInitFunc() и GBaseFinalizeFunc(). Кроме того, спецификация GClassFinalizeFunc() в структуре GTypeInfo статических типов недоступна, потому что классы статических типов никогда не финализируются (они искусственно поддерживаются когда количество их ссылок достигает нуля).

g_class :

Структура GTypeClass для финализации.

class_data :

Член class_data поставляемый через структуру GTypeInfo.

GInstanceInitFunc ()

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

instance :

Инициализируемый экземпляр.

g_class :

Класс создаваемого типового экземпляра.

GInterfaceInitFunc ()

Это callback-функция используемая системой типов для инициализации нового интерфейса. Эта функция должна инициализировать все внутренние данные и распределять любые ресурсы запрошенные интерфейсом.

g_iface :

Структура для инициализации интерфейса.

iface_data :

class_data поставляемый через структуру GTypeInfo.

GInterfaceFinalizeFunc ()

Это callback-функция используемая системой типов для финализации интерфейса. Эта функция должна уничтожать любые внутренние данные и освобождать любые ресурсы распределённые соответствующей функцией GInterfaceInitFunc().

g_iface :

Интерфейсная структура для финализации.

iface_data :

class_data поставляемый через структуру GTypeInfo.

GTypeClassCacheFunc ()

Эта callback-функция вызывается когда количество ссылок класса сбрасывается к нулю. Она может использовать g_type_class_ref() чтобы предотвратить освобождение класса. Вы не должны вызывать g_type_class_unref() из функции GTypeClassCacheFunc чтобы не допустить бесконечную рекурсию, используйте вместо неёg_type_class_unref_uncached().

Функции должны проверять id класса является ли он фактически кэшируеммым классом данного типа, так как все классы проходят через туже цепочку GTypeClassCacheFunc.

cache_data :

данные помещаемые в вызов g_type_add_class_cache_func()

g_class :

Структура GTypeClass на которую нет ссылок

Возвращает :

TRUE для прекращения последующих вызовов GTypeClassCacheFunc, FALSE для продолжения.

enum GTypeFlags

Битовая маска для контроля характеристик типа.

G_TYPE_FLAG_ABSTRACT

Указывает абстрактный тип. Экземпляры не могут быть созданы для абстрактного типа.

G_TYPE_FLAG_VALUE_ABSTRACT

Указывает значение абстрактного типа, то есть тип который введён в таблицу значений, но не может использоваться для g_value_init().

enum GTypeFundamentalFlags

Битовая маска используемая для контроля специфичных характеристик базового типа.

G_TYPE_FLAG_CLASSED

Указывает классифицированный тип.

G_TYPE_FLAG_INSTANTIATABLE

Указывает инстанциируемый тип (подразумевает классифицируемый).

G_TYPE_FLAG_DERIVABLE

Указывает простой наследуемыйй тип.

G_TYPE_FLAG_DEEP_DERIVABLE

Указывает глубину наследуемого типа (включая производный).

g_type_register_static ()

Регистрирует type_name как имя нового статичного типа унаследовавшего parent_type. Система типов использует информацию содержащуюся в структуре GTypeInfo указанной параметром info для управления типом и его экземплярами (если не абстрактный). Значение flags определяет природу типа (например абстрактный или нет).

parent_type :

Предок производного типа.

type_name :

0-завершённая строка используемая как имя нового типа.

info :

Структура GTypeInfo для данного типа.

flags :

Побитная комбинация значений GTypeFlags.

Возвращает :

Новый идентификатор типа.

g_type_register_static_simple ()

Регистрирует type_name как имя нового статичного типа унаследовавшего parent_type. Значение flags определяет природу типа (например абстрактный или нет). Она заполняет GTypeInfo структуру и вызывает g_type_register_static().

parent_type :

Тип который является предком производного типа.

type_name :

0-завершённая строка используемая как имя нового типа.

class_size :

Размер сструктуры класса (смотрите GTypeInfo)

class_init :

Расположение функции инициализации класса (смотрите GTypeInfo)

instance_size :

Размер сструктуры экземпляра (смотрите GTypeInfo)

instance_init :

Расположение функции инициализации экземпляра (смотрите GTypeInfo)

flags :

Побитная комбинация значений GTypeFlags.

Возвращает :

Идентификатор нового типа.

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

g_type_register_dynamic ()

Регистрирует type_name как имя нового динамического типа унаследовавшего parent_type. Система типов использует информацию содержащуюся в структуре GTypePlugin указанной параметром plugin для управления типом и его экземпляром (если не абстрактный). Значение flags определяет природу типа (например абстрактный или нет).

parent_type :

Предок данного типа.

type_name :

0-завершённая строка используемая как имя нового типа.

plugin :

Структура GTypePlugin в которой находится GTypeInfo.

flags :

Побитовая комбинация значений GTypeFlags.

Возвращает :

Идентификатор нового типа или G_TYPE_INVALID если регистрация не удалась.

g_type_register_fundamental ()

Регистрирует type_id как предопределённый идентификатор, а type_name как имя базового типа. Система типов использует информацию содержащуюся в структуре GTypeInfoуказанной параметром info и в структуре GTypeFundamentalInfo указанной параметром finfo для управления экземпляром типа. Значение flags определяет дополнительные характеристики базового типа.

type_id :

Предопределённое значение GTypeFundamentals.

type_name :

0-завершённая строка используемая как имя нового типа.

info :

Структура GTypeInfo данного типа.

finfo :

Структура GTypeFundamentalInfo для данного типа.

flags :

Побитная комбинация значений GTypeFlags.

Возвращает :

Предопределённый идентификатор типа.

g_type_add_interface_static ()

Добавляет статический interface_type к instantiable_type. Информация содержащаяся в структуре GTypeInterfaceInfo указанная параметром info используется для управления связью.

instance_type :

Значение GType инстанциируемого типа.

interface_type :

GType значение интерфейсного типа.

info :

Структура GInterfaceInfo для данной комбинации (instance_type, interface_type).

g_type_add_interface_dynamic ()

Добавляет динамический interface_type к instantiable_type. Информация содержащаяся в структуре GTypePlugin указанной параметром plugin используется для управления связью.

instance_type :

GType значение инстанциируемого типа.

interface_type :

GType значение интерфейсного типа.

plugin :

GTypePlugin структура находящаяся в GInterfaceInfo.

g_type_interface_add_prerequisite ()

Добавляет prerequisite_type в список предпосылок interface_type. Это значит что любая реализация типа interface_type должна так же реализовать prerequisite_type. Предпосылки могут рассматриваться как альтернатива интерфейсного ответвления (которые не поддерживает GType). Интерфейс может иметь один инстанциируемый тип предпосылки.

interface_type :

GType значение интерфейсного типа.

prerequisite_type :

GType значение интерфейсного инстанциируемого типа.

g_type_get_plugin ()

Возвращает структуру GTypePlugin для type или NULL если type не имеет структуру GTypePlugin.

type :

GType для поиска модуля (plugin).

Возвращает :

Соответствующий модуль если type является динамическим типом, иначе NULL.

g_type_interface_get_plugin ()

Возвращает структуру GTypePlugin для динамического интерфейса interface_type который был добавлен к instance_type, или NULL если interface_type не добавлен к instance_type или если не имеет GTypePlugin структуру. Смотрите g_type_add_interface_dynamic().

instance_type :

GType значение инстанциируемого типа.

interface_type :

GType значение интерфейсного типа.

Возвращает :

GTypePlugin для динамического интерфейса interface_type принадлежащего instance_type.

g_type_fundamental_next ()

Возвращает следующий свободный идентификатор базового типа который можно использовать для регистрации нового базового типа с помощью g_type_register_fundamental(). Возвращаемый ID типа представляет наивысший регистрируемый идентификатор базового типа.

Возвращает :

Следующий за последним ID зарегистрированного базового типа, или 0 если система типов исчерпала идентификаторы базовых типов.

g_type_fundamental ()

Внутренняя функция, используется для извлечения части ID базового типа. вместо неё используйте G_TYPE_FUNDAMENTAL().

type_id :

допустимый ID типа

Возвращает :

ID базового типа

g_type_create_instance ()

Создаёт инициализированный экземпляр type если type является допустимым и может быть инстанциирован. Система типов выполняет только основное распределение и установку сструктуры для экземпляра: фактически экземпляр создаётся функциями поставляемыми реализацией базового типа. Поэтому использование g_type_create_instance()зарезервировано только для реализации базового типа. Например экземпляры иерархии GObject должны создаваться через g_object_new() и никогда не должны создаваться непосредственно через g_type_create_instance() которая не обрабатывает такие вещи как единственный ребёнок объекта или конструкцию объекта. Помните: Не используйте эту функцию, кроме как для реализации базового типа. Также языковые привязки не должны использовать эту функцию, а использовать вместо неё g_object_new().

type :

Инстанциируемый тип для создания экземпляра.

Возвращает :

Распределённый и инициализированный экземпляр, подвергается дальнейшей обработке реализацией базового типа.

g_type_free_instance ()

Освобождает экземпляр типа, возвращает его в пул экземпляров типа, если он есть.

Как g_type_create_instance(), эта функция зарезервирована для реализаций базовых типов.

instance :

экземпляр типа.

g_type_add_class_cache_func ()

Добавляет GTypeClassCacheFunc которая будет вызвана перед сбросом количества ссылок класса в ноль. Это может использоваться для предотвращения преждевременного разрушения класса. Все установленные функции GTypeClassCacheFunc будут скованы пока одна из них не вернёт TRUE. Функции должны контролировать помещаемый id класс, должна ли она фактически кэшировать класс этого типа, так как все классы направляются через туже цепочку GTypeClassCacheFunc.

cache_data :

данные помещаемые в cache_func

cache_func :

GTypeClassCacheFunc

g_type_remove_class_cache_func ()

Удаляет предварительно установленную GTypeClassCacheFunc. Кэш содержащийся в cache_func должен быть пустым когда вызывается g_type_remove_class_cache_func()чтобы избежать утечек.

cache_data :

данные полученные при добавлении cache_func

cache_func :

GTypeClassCacheFunc

g_type_class_unref_uncached ()

Вариант g_type_class_unref() для использования в GTypeClassCacheFunc реализации. Она отменяет ссылку на класс без контроля цепочки GTypeClassCacheFunc, избегая рекурсии которая моглабы иначе произойти.

g_class :

Структура GTypeClass для отмены ссылок.

g_type_add_interface_check ()

Добавляет функцию вызываемую после инициализации vtable интерфейса для любого класса (то есть после вызова interface_init члена GInterfaceInfo).

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

check_data :

данные помещаемые в check_func

check_func :

функция вызываемая после каждой инициализации интерфейса.

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

g_type_remove_interface_check ()

Удаляет интерфейсную функцию контроля добавленную с помощью g_type_add_interface_check().

check_data :

данные callback-функции помещаемые в g_type_add_interface_check()

check_func :

callback-функция помещаемая в g_type_add_interface_check()

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

GTypeInterfaceCheckFunc ()

Эта callback-функция вызывается после инициализации vtable интерфейса. Смотрите g_type_add_interface_check().

check_data :

данные помещаемые в g_type_add_interface_check().

g_iface :

инициализируемый интерфейс

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

g_type_value_table_peek ()

Возвращает расположение GTypeValueTable связанной с type. Помните что эта функция должна использоваться только из исходного кода который реализует или знает внутреннюю реализацию type.

type :

GType значение.

Возвращает :

Расположение GTypeValueTable связанной с type или NULL если нет GTypeValueTable связанной с type.

G_DEFINE_TYPE()

Удобный макрос для реализации типа, который декларирует функцию инициализации класса, функцию инициализации экземпляра (смотрите GTypeInfo для информации об этом) и статическую переменную с именем t_n_parent_class указывающую на родительский класс. Кроме того, он определяет функцию *_get_type(). Смотрите G_DEFINE_TYPE_EXTENDED()для примера.

TN :

Имя нового типа, в верхнем регистре.

t_n :

Имя нового типа, в нижнем регистре, со словами разделёнными символом '_'.

T_P :

GType родительского типа.

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

G_DEFINE_TYPE_WITH_CODE()

Удобный макрос для реализации типа. Похож на G_DEFINE_TYPE(), но позволяет вставить произвольный код в функцию *_get_type(), например реализовать интерфейс через G_IMPLEMENT_INTERFACE(). Смотрите G_DEFINE_TYPE_EXTENDED() для примера.

TN :

имя нового типа в верхнем регистре (in Camel case).

t_n :

имя нового типа в нижнем регистре, со словами разделёнными знаком '_'.

T_P :

GType родительского типа.

_C_ :

Произвольный код который вставляется в функцию *_get_type().

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

G_DEFINE_ABSTRACT_TYPE()

Удобный макрос для реализации типа. Похож на G_DEFINE_TYPE(), но определяет абстрактный тип. Смотрите G_DEFINE_TYPE_EXTENDED() для примера.

TN :

имя нового типа в верхнем регистре (in Camel case).

t_n :

имя нового типа в нижнем регистре, со словами разделёнными знаком '_'.

T_P :

GType родительского типа.

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

G_DEFINE_ABSTRACT_TYPE_WITH_CODE()

Удобный макрос для реализации типа. Похож на G_DEFINE_TYPE_WITH_CODE(), определяет абстрактный тип и позволяет вставить произвольный код в функцию *_get_type(), например реализовать интерфейс через G_IMPLEMENT_INTERFACE(). Смотрите G_DEFINE_TYPE_EXTENDED() для примера.

TN :

имя нового типа, в верхнем регистре (in Camel case).

t_n :

имя нового типа в нижнем регистре, со словами разделёнными символом '_'.

T_P :

GType родительского типа.

_C_ :

Произвольный код вставляемый в функцию @type_name_get_type().

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

G_IMPLEMENT_INTERFACE()

Удобный макрос для простого добавления интерфейса в _C_ раздел G_DEFINE_TYPE_WITH_CODE() или G_DEFINE_ABSTRACT_TYPE_WITH_CODE(). Смотрите G_DEFINE_TYPE_EXTENDED() для примера.

Помните что этот макрос может использоваться только вместе с G_DEFINE_TYPE_* макросами, так как он зависит от переменных имён из этих макросов.

TYPE_IFACE :

GType добавляемого интерфейса

iface_init :

Функция инициализации интерфейса

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

G_DEFINE_TYPE_EXTENDED()

Основной макрос для удобной реализации типа, на котором основан G_DEFINE_TYPE(), и так далее.

разворачивается до

Единственные части определяемые вручную это сструктуры интерфейса и класса и определение функций инициализации экземпляра и класса.

TN :

t_n :

T_P :

_f_ :

_C_ :

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

G_TYPE_INVALID

Недопустимый GType используется как ошибочное значение которое возвращают некоторые функции возвращающие GType.

G_TYPE_NONE

Базовый тип который используется как замена для возвращаемого типа C void.

G_TYPE_INTERFACE

Базовый тип из который наследуют все интерфейсы.

G_TYPE_CHAR

Базовый тип соответствующий gchar. Тип подписываемый с помощью G_TYPE_CHAR беззаговорочно 8-битное целочисленное со знаком. Это может быть или не может быть тем же C типом "gchar".

G_TYPE_UCHAR

Базовый тип соответствующий guchar.

G_TYPE_BOOLEAN

Базовый тип соответствующий gboolean.

G_TYPE_INT

Базовый тип соответствующий gint.

G_TYPE_UINT

Базовый тип соответствующий guint.

G_TYPE_LONG

Базовый тип соответствующий glong.

G_TYPE_ULONG

Базовый тип соответствующий gulong.

G_TYPE_INT64

Базовый тип соответствующий gint64.

G_TYPE_UINT64

Базовый тип соответствующий guint64.

G_TYPE_ENUM

Базовый тип который наследуют все перечислимые типы.

G_TYPE_FLAGS

Базовый тип который наследуют все флаговые типы.

G_TYPE_FLOAT

Базовый тип соответствующий gfloat.

G_TYPE_DOUBLE

Базовый тип соответствующий gdouble.

G_TYPE_STRING

Базовый тип соответствующий nul-завершённой C строке.

G_TYPE_POINTER

Базовый тип соответствующий gpointer.

G_TYPE_BOXED

Базовый тип который наследуют все boxed типы.

G_TYPE_PARAM

Базовый тип который наследуют все GParamSpec типы.

G_TYPE_OBJECT

Базовый тип для GObject.

G_TYPE_GTYPE

Тип для GType.

G_TYPE_RESERVED_GLIB_FIRST

Первый номер базового типа для создания идентификатора базового типа с помощью G_TYPE_MAKE_FUNDAMENTAL() зарезервированный для GLib.

G_TYPE_RESERVED_GLIB_LAST

Последний номер базового типа зарезервированный для GLib.

G_TYPE_RESERVED_BSE_FIRST

Первый номер базового типа для создания идентификатора базового типа с помощью G_TYPE_MAKE_FUNDAMENTAL() зарезервированный для BSE.

G_TYPE_RESERVED_BSE_LAST

Последний номер базового типа зарезервированный для BSE.

G_TYPE_RESERVED_USER_FIRST

Первый доступный номер базового типа для создания нового идентификатора базового типа с помощью G_TYPE_MAKE_FUNDAMENTAL().

PreviousСигналыNextGTypePlugin

Last updated

Was this helpful?