Version Information

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

Version Information — Переменные и функции для проверки версии GLib

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



#include <glib.h>


extern      const guint glib_major_version;
extern      const guint glib_minor_version;
extern      const guint glib_micro_version;
extern      const guint glib_binary_age;
extern      const guint glib_interface_age;
const gchar* glib_check_version             (guint required_major,
                                             guint required_minor,
                                             guint required_micro);

#define     GLIB_MAJOR_VERSION
#define     GLIB_MINOR_VERSION
#define     GLIB_MICRO_VERSION
#define     GLIB_CHECK_VERSION              (major,minor,micro)

Описание

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

Детали

glib_major_version

extern const guint glib_major_version;

Основной номер библиотеки GLib. (например в GLib версии 1.2.5 это 1.)

Эта переменная находится в библиотеке, таким образом представляется библиотека GLib к которой вы привязываетесь. В отличии от макроса GLIB_MAJOR_VERSION, который представляет главную версию заголовков GLib которые вы включили.

glib_minor_version

extern const guint glib_minor_version;

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

Эта переменная находится в библиотеки, таким образом представляя библиотеку GLib к которой вы привязываетесь. В отличии от макроса GLIB_MINOR_VERSION, который представляет младший номер версии заголовков GLib которые вы включили.

glib_micro_version

extern const guint glib_micro_version;

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

Эта переменная находится в библиотеки, таким образом представляя библиотеку GLib к которой вы привязываетесь. В отличии от макроса GLIB_MICRO_VERSION, который представляет наименьший номер версии заголовков GLib которые вы включили.

glib_binary_age

extern const guint glib_binary_age;

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

glib_interface_age

extern const guint glib_interface_age;

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

glib_check_version ()

const gchar* glib_check_version             (guint required_major,
                                             guint required_minor,
                                             guint required_micro);

Проверяет что библиотека GLib совместима с полученной версией. В основном вы должны помещать константы GLIB_MAJOR_VERSION, GLIB_MINOR_VERSION, GLIB_MICRO_VERSION как три аргумента для этой функции; это производит проверку что используемая библиотека совместима с версией GLib приложения, или напротив были собраны модули.

Совместимость определяется двумя вещами: сначала версия запущенной библиотеки новее чем версия required_major.required_minor. required_micro. Затем выполняемая библиотека должна быть бинарно совместима с версией required_major.required_minor.required_micro (одинаковый главный номер версии.)

`required_major` :	необходимая главная версия.
`required_minor` :	необходимая младшая версия.
`required_micro` :	необходимая наименьшая версия.
Возвращает :	`NULL` если библиотека GLib совместима с полученной версией, или строку описывающую несоответствие версий. Возвращаемой строкой владеет GLib и она не должна модифицироваться или освобождаться.

Начиная с версии 2.6

GLIB_MAJOR_VERSION

#define GLIB_MAJOR_VERSION 2

Главный номер версии библиотеки GLib. Тоже самое что glib_major_version, но из заголовков используемых во время компиляции приложения, вместо библиотеки связываемой с приложением во время выполнения.

GLIB_MINOR_VERSION

#define GLIB_MINOR_VERSION 13

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

GLIB_MICRO_VERSION

#define GLIB_MICRO_VERSION 0

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

GLIB_CHECK_VERSION()

#define GLIB_CHECK_VERSION(major,minor,micro)

Проверяет номер версии библиотеки GLib. Возвращает TRUE если версия заголовочных файлов GLib та же самая или более новая чем передаваемая.

Пример 1. Проверка версии библиотеки GLib


  if (!GLIB_CHECK_VERSION (1, 2, 0))
    g_error ("GLib version 1.2.0 or above is needed");

`major` :	главный номер версии.
`minor` :	младший номер версии.
`micro` :	наименьший номер версии.

			Справочное описание GLib
Начало \| Описание