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

#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+.

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+ таже самая или более новая чем помещённая в версию.