glib-genmarshal - Интернет в облаке

ПРОГРАММА:

ИМЯ

glib-genmarshal - Утилита генерации маршаллера кода C для замыканий GLib

СИНТАКСИС

бойко-генмаршал [ВАРИАНТ ...] [ФАЙЛ ...]

ОПИСАНИЕ

бойко-генмаршал это небольшая утилита, которая генерирует маршаллеры кода C для обратного вызова
функции механизма GClosure в подбиблиотеке GObject библиотеки GLib. Маршаллер
функции имеют стандартную сигнатуру, они передаются в вызывающем замыкании, массив
структуры значений, содержащие параметры функции обратного вызова и структуру значений для
возвращаемое значение обратного вызова. Затем маршаллер должен вызвать соответствующий C
кодировать функцию закрытия со всеми параметрами в стеке и собирать ее
возвращаемое значение.

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

Маршаллер список формат
Списки маршаллера обрабатываются построчно, строка может содержать комментарий в виде
of
или спецификация маршаллера формы

RТИП:ТИП
RТИП:ТИП,ТИП
RТИП:ТИП,ТИП,ТИП

(до 16 ТИПs может присутствовать).

" RТИП часть определяет тип возвращаемого значения обратного вызова и ТИППраво на толстую кишку
укажите список параметров обратного вызова, за исключением первого и последнего аргументов, которые
всегда указатели.

Параметр Типы
В настоящее время поддерживаются следующие типы:

VOID
указывает отсутствие возвращаемого типа или дополнительных параметров. Если VOID используется как параметр
list, никакие дополнительные параметры не могут присутствовать.

БУЛЕВЫ
для логических типов (gboolean)

CHAR
для подписанных типов char (gchar)

УЧАР
для беззнаковых типов символов (гучар)

INT
для целочисленных типов со знаком (gint)

UINT
для беззнаковых целочисленных типов (гвинт)

ДЛИННЫЙ
для длинных целочисленных типов со знаком (glong)

УЛОНГ
для беззнаковых длинных целочисленных типов (гулонг)

INT64
для 64-битных целочисленных типов со знаком (gint64)

UINT64
для беззнаковых 64-битных целочисленных типов (guint64)

ПЕРЕЧИСЛЕНИЕ
для перечислимых типов (гинт)

ФЛАГИ
для типов перечисления флагов (guint)

FLOAT
для типов с плавающей запятой одинарной точности (gfloat)

ДВОЙНОЙ
для типов с плавающей запятой двойной точности (gdouble)

STRING
для строковых типов (gchar *)

В КОРОБКЕ
для упакованных (анонимных, но с подсчетом ссылок) типов (GBoxed *)

ПАРАМ
для GParamSpec или производных типов (GParamSpec *)

УКАЗАТЕЛЬ
для типов анонимных указателей (gpointer)

ОБЪЕКТ
для GObject или производных типов (GObject *)

ВАРИАНТ
для типов GVariant (GVariant *)

NONE
устаревший псевдоним для VOID

BOOL
устаревший псевдоним для БУЛЕВЫ

ДОПОЛНИТЕЛЬНЫЕ ОПЦИИ

- заголовок
Сгенерируйте содержимое файла заголовка маршаллеров.

--тело
Сгенерируйте содержимое файла кода C для маршаллеров.

--prefix =ПРЕФИКС
Укажите префикс маршаллера. Префикс по умолчанию - g_cclosure_marshal.

- пропустить источник
Пропускать примечания к исходному местоположению в сгенерированных комментариях.

--stdinc
Используйте стандартные маршаллеры библиотеки GObject и включите gmarshal.h в
сгенерированные файлы заголовков.

--nostdinc
Не используйте стандартные маршаллеры библиотеки GObject и пропустите gmarshal.h
Директива include в сгенерированных файлах заголовков.

--внутренний
Отметьте сгенерированные функции как внутренние, используя G_GNUC_INTERNAL.

--валисты-маршаллеры
Сгенерируйте маршаллеры valist для использования с g_signal_set_va_marshaller ().

-v, --версия
Информация о версии для печати.

--g-фатальные-предупреждения
Сделайте предупреждения фатальными, то есть немедленно завершите работу при появлении предупреждения.

-h, --Помогите
Распечатайте краткую справку и выйдите.

-v, --версия
Версия для печати и выход.

ПРИМЕР

Чтобы сгенерировать маршаллеры для следующих функций обратного вызова:

void foo (gpointer data1,
данные gpointer2);
пустая панель (gpointer data1,
джинт param1,
данные gpointer2);
gfloat baz (данные gpointer1,
gboolean параметр1,
гучар парам2,
данные gpointer2);

Файл marshaller.list должен выглядеть так:

НЕДЕЙСТВИТЕЛЬНО: НЕДЕЙСТВИТЕЛЬНО
НЕДЕЙСТВИТЕЛЬНО: INT
FLOAT: BOOLEAN, UCHAR

и вы вызываете glib-genmarshal вот так:

glib-genmarshal --header marshaller.list> marshaller.h
glib-genmarshal --body marshaller.list> marshaller.c

Аргументы сгенерированных маршаллеров закодированы в имени функции. Для этого
конкретный список, они

g_cclosure_user_marshal_VOID__VOID (),
g_cclosure_user_marshal_VOID__INT (),
g_cclosure_user_marshal_FLOAT__BOOLEAN_UCHAR ().

Их можно использовать непосредственно для GClosures или передать как GSignalCMarshaller.
c_marshaller; аргумент при создании сигналов:

GClosure * cc_foo, * cc_bar, * cc_baz;

cc_foo = g_cclosure_new (NULL, foo, NULL);
g_closure_set_marshal (cc_foo, g_cclosure_user_marshal_VOID__VOID);
cc_bar = g_cclosure_new (NULL, бар, NULL);
g_closure_set_marshal (cc_bar, g_cclosure_user_marshal_VOID__INT);
cc_baz = g_cclosure_new (NULL, baz, NULL);
g_close_set_marshal(cc_baz, g_cclosure_user_marshal_FLOAT__BOOLEAN_UCHAR);

Используйте glib-genmarshal онлайн с помощью сервисов onworks.net