Spec-Zone.ru › GTK 4.0

Информация о версии

Информация о версии — Переменные и функции для проверки версии GTK

Функции

guint gtk_get_major_version ()
guint gtk_get_minor_version ()
guint gtk_get_micro_version ()
guint gtk_get_binary_age ()
guint gtk_get_interface_age ()
const char * gtk_check_version ()
#define GTK_CHECK_VERSION()

Типы и значения

#define GTK_MAJOR_VERSION
#define GTK_MINOR_VERSION
#define GTK_MICRO_VERSION
#define GTK_BINARY_AGE
#define GTK_INTERFACE_AGE

Включения

#include <gtk/gtk.h>

Описание

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

Функции

gtk_get_major_version ()

guint
gtk_get_major_version (void);

Возвращает номер основной версии библиотеки GTK. (Например, в GTK версии 3.1.5 это 3.)

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

Возвращает

номер основной версии библиотеки GTK

gtk_get_minor_version ()

guint
gtk_get_minor_version (void);

Возвращает номер дополнительной версии библиотеки GTK. (Например, в GTK версии 3.1.5 это 1.)

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

Возвращает

номер дополнительной версии библиотеки GTK

gtk_get_micro_version ()

guint
gtk_get_micro_version (void);

Возвращает номер микроверсии библиотеки GTK. (Например, в GTK версии 3.1.5 это 5.)

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

Возвращает

номер микроверсии библиотеки GTK

gtk_get_binary_age ()

guint
gtk_get_binary_age (void);

Возвращает возраст двоичного файла, переданный libtool при построении библиотеки GTK, с которой работает процесс. Если libtool для вас ничего не значит, не беспокойтесь.

Возвращает

возраст двоичного файла библиотеки GTK

gtk_get_interface_age ()

guint
gtk_get_interface_age (void);

Возвращает возраст интерфейса, переданный libtool при построении библиотеки GTK, с которой работает процесс. Если libtool для вас ничего не значит, не беспокойтесь.

Возвращает

возраст интерфейса библиотеки GTK

gtk_check_version ()

const char *
gtk_check_version (guint required_major,
                   guint required_minor,
                   guint required_micro);

Проверяет, совместима ли используемая библиотека GTK с заданной версией. Как правило, вы передаете константы GTK_MAJOR_VERSION, GTK_MINOR_VERSION, GTK_MICRO_VERSION в качестве трех аргументов этой функции; это обеспечивает проверку совместимости используемой библиотеки с версией GTK, с которой было скомпилировано приложение или модуль.

Совместимость определяется двумя факторами: во-первых, версия работающей библиотеки должна быть новее, чем версия required_major.required_minor .required_micro. Во-вторых, работающая библиотека должна быть двоично совместима с версией required_major.required_minor .required_micro (одинаковая основная версия).

Эта функция предназначена в первую очередь для модулей GTK; модуль может вызвать эту функцию, чтобы проверить, не был ли он загружен в несовместимую версию GTK. Однако такая проверка не является полностью надежной, поскольку модуль может быть связан со старой версией GTK и вызывать старую версию gtk_check_version(), но при этом загружаться в приложение, использующее более новую версию GTK.

Параметры

required_major

требуемая основная версия

required_minor

требуемая дополнительная версия

required_micro

требуемая микроверсия

Возвращает

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

[nullable]

GTK_CHECK_VERSION()

#define             GTK_CHECK_VERSION(major,minor,micro)

Возвращает TRUE если версия файлов заголовков GTK совпадает или новее, чем переданная версия.

Параметры

major

основная версия (например, 1 для версии 1.2.5)

minor

дополнительная версия (например, 2 для версии 1.2.5)

micro

микроверсия (например, 5 для версии 1.2.5)

Возвращает

TRUE если заголовки GTK достаточно новые

Типы и значения

GTK_MAJOR_VERSION

#define GTK_MAJOR_VERSION (4)

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

GTK_MINOR-VERSION

#define GTK_MINOR_VERSION (0)

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

GTK_MICRO-VERSION

#define GTK_MICRO_VERSION (3)

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

GTK_BINARY-AGE

#define GTK_BINARY_AGE    (3)

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

GTK_INTERFACE-AGE

#define GTK_INTERFACE_AGE (3)

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

© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer-old.gnome.org/gtk4/4.0/gtk4-Feature-Test-Macros.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API