Информация о версии
Информация о версии — Переменные и функции для проверки версии 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