Prev

Up

Home

GTK+ Reference Manual

Next

Top  |  Description

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

Version Information Переменные и функции для контроля версии GTK+

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

#include <gtk/gtk.h> extern const guint gtk_major_version; extern const guint gtk_minor_version; extern const guint gtk_micro_version; extern const guint gtk_binary_age; extern const guint gtk_interface_age; gchar* gtk_check_version (guint required_major, guint required_minor, guint required_micro); #define GTK_MAJOR_VERSION #define GTK_MINOR_VERSION #define GTK_MICRO_VERSION #define GTK_BINARY_AGE #define GTK_INTERFACE_AGE #define GTK_CHECK_VERSION (major,minor,micro)

Описание

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

Детали

gtk_major_version

extern const guint gtk_major_version;

Главный номер библиотеки GTK+. (например в GTK+ версии 1.2.5 это 1.)

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


gtk_minor_version

extern const guint gtk_minor_version;

Младший номер версии библиотеки GTK+. (например в GTK+ версии 1.2.5 это 2.)

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


gtk_micro_version

extern const guint gtk_micro_version;

Наименьший номер версии библиотеки GTK+. (например в GTK+ версии 1.2.5 это 5.)

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


gtk_binary_age

extern const guint gtk_binary_age;

Это бинарный возраст помещаемый в libtool. Если libtool для вас не о чём не говорит, не волнуйтесь об этом. ;-)


gtk_interface_age

extern const guint gtk_interface_age;

Это возраст интерфейса помещаемый в libtool. Если libtool для вас не о чём не говорит, не волнуйтесь об этом. ;-)


gtk_check_version ()

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 :

Требуемый наименьший номер версии.

Returns :

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


GTK_MAJOR_VERSION

#define GTK_MAJOR_VERSION                               (2)

Как gtk_major_version, но из заголовочных фалов используемых приложением во время компиляции, а не из библиотеки связанной с приложением во время исполнения.


GTK_MINOR_VERSION

#define GTK_MINOR_VERSION                               (8)

Как gtk_minor_version, но из заголовочных фалов используемых приложением во время компиляции, а не из библиотеки связанной с приложением во время исполнения.


GTK_MICRO_VERSION

#define GTK_MICRO_VERSION                               (11)

Как gtk_micro_version, но из заголовочных фалов используемых приложением во время компиляции, а не из библиотеки связанной с приложением во время исполнения.


GTK_BINARY_AGE

#define GTK_BINARY_AGE                                  (811)

Как gtk_binary_age, но из заголовочных фалов используемых приложением во время компиляции, а не из библиотеки связанной с приложением во время исполнения.


GTK_INTERFACE_AGE

#define GTK_INTERFACE_AGE                               (11)

Как gtk_interface_age, но из заголовочных фалов используемых приложением во время компиляции, а не из библиотеки связанной с приложением во время исполнения.


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)