Информация о версии
Информация о версии — Переменные и функции для проверки версии 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 gchar * | 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 |
| #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+
С версии: 3.0
gtk_get_minor_version ()
guint
gtk_get_minor_version (void); Возвращает номер дополнительной версии библиотеки GTK+. (Например, в GTK+ версии 3.1.5 это 1.)
Эта функция находится в библиотеке, поэтому она представляет собой библиотеку GTK+, с которой работает ваш код. Проведите аналогию с макросом GTK_MINOR_VERSION, который представляет собой дополнительную версию заголовков GTK+, включённых при компиляции вашего кода.
Возвращает
номер дополнительной версии библиотеки GTK+
С версии: 3.0
gtk_get_micro_version ()
guint
gtk_get_micro_version (void); Возвращает номер микроверсии библиотеки GTK+. (Например, в GTK+ версии 3.1.5 это 5.)
Эта функция находится в библиотеке, поэтому она представляет собой библиотеку GTK+, с которой работает ваш код. Проведите аналогию с макросом GTK_MICRO_VERSION, который представляет собой микроверсию заголовков GTK+, включённых при компиляции вашего кода.
Возвращает
номер микроверсии библиотеки GTK+
С версии: 3.0
gtk_get_binary_age ()
guint
gtk_get_binary_age (void); Возвращает возраст бинарного кода, переданный в libtool при построении библиотеки GTK+, с которой работает процесс. Если libtool вам не знакомо, не беспокойтесь об этом.
Возвращает
возраст бинарного кода библиотеки GTK+
С версии: 3.0
gtk_get_interface_age ()
guint
gtk_get_interface_age (void); Возвращает возраст интерфейса, переданный в libtool при построении библиотеки GTK+, с которой работает процесс. Если libtool вам не знакомо, не беспокойтесь об этом.
Возвращает
возраст интерфейса библиотеки GTK+
С версии: 3.0
gtk_check_version ()
const gchar * 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 gtk_get_major_version ()
gtk_minor_version
#define gtk_minor_version gtk_get_minor_version ()
gtk_micro_version
#define gtk_micro_version gtk_get_micro_version ()
gtk_binary_age
#define gtk_binary_age gtk_get_binary_age ()
gtk_interface_age
#define gtk_interface_age gtk_get_interface_age ()
GTK_MAJOR_VERSION
#define GTK_MAJOR_VERSION (3)
Как gtk_get_major_version(), но из заголовков, используемых на стадии компиляции приложения, а не из библиотеки, подключаемой во время выполнения приложения.
GTK_MINOR-VERSION
#define GTK_MINOR_VERSION (22)
Как gtk_get_minor_version(), но из заголовков, используемых на стадии компиляции приложения, а не из библиотеки, подключаемой во время выполнения приложения.
GTK_MICRO-VERSION
#define GTK_MICRO_VERSION (3)
Как gtk_get_micro_version(), но из заголовков, используемых на стадии компиляции приложения, а не из библиотеки, подключаемой во время выполнения приложения.
GTK_BINARY-AGE
#define GTK_BINARY_AGE (2203)
Как 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.gnome.org/gtk3/3.22/gtk3-Feature-Test-Macros.html