Versioning macros

Versioning macros — Variables and functions to check the ATK version

Synopsis

guint               atk_get_major_version               (void);
guint               atk_get_minor_version               (void);
guint               atk_get_micro_version               (void);
guint               atk_get_binary_age                  (void);
guint               atk_get_interface_age               (void);
#define             ATK_MAJOR_VERSION
#define             ATK_MINOR_VERSION
#define             ATK_MICRO_VERSION
#define             ATK_CHECK_VERSION                   (major,
                                                         minor,
                                                         micro)

Description

ATK provides a set of macros and methods for checking the version of the library at compile and run time.

Details

atk_get_major_version ()

guint               atk_get_major_version               (void);

Returns the major version number of the ATK library. (e.g. in ATK version 2.7.4 this is 2.)

This function is in the library, so it represents the ATK library your code is running against. In contrast, the ATK_MAJOR_VERSION macro represents the major version of the ATK headers you have included when compiling your code.

Returns :

the major version number of the ATK library

Since 2.7.4


atk_get_minor_version ()

guint               atk_get_minor_version               (void);

Returns the minor version number of the ATK library. (e.g. in ATK version 2.7.4 this is 7.)

This function is in the library, so it represents the ATK library your code is are running against. In contrast, the ATK_MINOR_VERSION macro represents the minor version of the ATK headers you have included when compiling your code.

Returns :

the minor version number of the ATK library

Since 2.7.4


atk_get_micro_version ()

guint               atk_get_micro_version               (void);

Returns the micro version number of the ATK library. (e.g. in ATK version 2.7.4 this is 4.)

This function is in the library, so it represents the ATK library your code is are running against. In contrast, the ATK_MICRO_VERSION macro represents the micro version of the ATK headers you have included when compiling your code.

Returns :

the micro version number of the ATK library

Since 2.7.4


atk_get_binary_age ()

guint               atk_get_binary_age                  (void);

Returns the binary age as passed to libtool when building the ATK library the process is running against.

Returns :

the binary age of the ATK library

Since 2.7.4


atk_get_interface_age ()

guint               atk_get_interface_age               (void);

Returns the interface age as passed to libtool when building the ATK library the process is running against.

Returns :

the interface age of the ATK library

Since 2.7.4


ATK_MAJOR_VERSION

#define ATK_MAJOR_VERSION (2)

Like atk_get_major_version(), but from the headers used at application compile time, rather than from the library linked against at application run time.

Since 2.7.4


ATK_MINOR_VERSION

#define ATK_MINOR_VERSION (8)

Like atk_get_minor_version(), but from the headers used at application compile time, rather than from the library linked against at application run time.

Since 2.7.4


ATK_MICRO_VERSION

#define ATK_MICRO_VERSION (0)

Like atk_get_micro_version(), but from the headers used at application compile time, rather than from the library linked against at application run time.

Since 2.7.4


ATK_CHECK_VERSION()

#define             ATK_CHECK_VERSION(major,minor,micro)

major :

major version (e.g. 1 for version 1.2.5)

minor :

minor version (e.g. 2 for version 1.2.5)

micro :

micro version (e.g. 5 for version 1.2.5)

Returns :

TRUE if the version of the ATK header files is the same as or newer than the passed-in version.

Since 2.7.4