Version Information

Version Information — Variables and functions to check the GTK version

Functions

Types and Values

Includes

#include <gtk/gtk.h>

Description

GTK provides version information, primarily useful in configure checks for builds that have a configure script. Applications will not typically use the features described here.

Functions

gtk_get_major_version ()

guint
gtk_get_major_version (void);

Returns the major version number of the GTK library. (e.g. in GTK version 3.1.5 this is 3.)

This function is in the library, so it represents the GTK library your code is running against. Contrast with the GTK_MAJOR_VERSION macro, which represents the major version of the GTK headers you have included when compiling your code.

Returns

the major version number of the GTK library


gtk_get_minor_version ()

guint
gtk_get_minor_version (void);

Returns the minor version number of the GTK library. (e.g. in GTK version 3.1.5 this is 1.)

This function is in the library, so it represents the GTK library your code is are running against. Contrast with the GTK_MINOR_VERSION macro, which represents the minor version of the GTK headers you have included when compiling your code.

Returns

the minor version number of the GTK library


gtk_get_micro_version ()

guint
gtk_get_micro_version (void);

Returns the micro version number of the GTK library. (e.g. in GTK version 3.1.5 this is 5.)

This function is in the library, so it represents the GTK library your code is are running against. Contrast with the GTK_MICRO_VERSION macro, which represents the micro version of the GTK headers you have included when compiling your code.

Returns

the micro version number of the GTK library


gtk_get_binary_age ()

guint
gtk_get_binary_age (void);

Returns the binary age as passed to libtool when building the GTK library the process is running against. If libtool means nothing to you, don't worry about it.

Returns

the binary age of the GTK library


gtk_get_interface_age ()

guint
gtk_get_interface_age (void);

Returns the interface age as passed to libtool when building the GTK library the process is running against. If libtool means nothing to you, don't worry about it.

Returns

the interface age of the GTK library


gtk_check_version ()

const char *
gtk_check_version (guint required_major,
                   guint required_minor,
                   guint required_micro);

Checks that the GTK library in use is compatible with the given version. Generally you would pass in the constants GTK_MAJOR_VERSION, GTK_MINOR_VERSION, GTK_MICRO_VERSION as the three arguments to this function; that produces a check that the library in use is compatible with the version of GTK the application or module was compiled against.

Compatibility is defined by two things: first the version of the running library is newer than the version required_major.required_minor .required_micro . Second the running library must be binary compatible with the version required_major.required_minor .required_micro (same major version.)

This function is primarily for GTK modules; the module can call this function to check that it wasn’t loaded into an incompatible version of GTK. However, such a check isn’t completely reliable, since the module may be linked against an old version of GTK and calling the old version of gtk_check_version(), but still get loaded into an application using a newer version of GTK.

Parameters

required_major

the required major version

 

required_minor

the required minor version

 

required_micro

the required micro version

 

Returns

NULL if the GTK library is compatible with the given version, or a string describing the version mismatch. The returned string is owned by GTK and should not be modified or freed.

[nullable]


GTK_CHECK_VERSION()

#define             GTK_CHECK_VERSION(major,minor,micro)

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

Parameters

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 GTK headers are new enough

Types and Values

GTK_MAJOR_VERSION

#define GTK_MAJOR_VERSION (4)

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


GTK_MINOR_VERSION

#define GTK_MINOR_VERSION (0)

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


GTK_MICRO_VERSION

#define GTK_MICRO_VERSION (3)

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


GTK_BINARY_AGE

#define GTK_BINARY_AGE    (3)

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


GTK_INTERFACE_AGE

#define GTK_INTERFACE_AGE (3)

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