Top |
Functions
guint | gtk_get_major_version () |
guint | gtk_get_minor_version () |
guint | gtk_get_micro_version () |
guint | gtk_get_binary_age () |
guint | gtk_get_interface_age () |
const char * | gtk_check_version () |
#define | GTK_CHECK_VERSION() |
Types and Values
#define | GTK_MAJOR_VERSION |
#define | GTK_MINOR_VERSION |
#define | GTK_MICRO_VERSION |
#define | GTK_BINARY_AGE |
#define | GTK_INTERFACE_AGE |
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.
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.
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.
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.
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.
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.
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.
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.