Version Information

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

Run-time Version Numbers

The variables glib_major_version, glib_minor_version, glib_micro_version, glib_binary_age and glib_interface_age are all available to check.

They can be compared using the function glib_check_version().

Compile-time Version Numbers

Version Numbers

The GLib headers annotate deprecated APIs in a way that produces compiler warnings if these deprecated APIs are used. The warnings can be turned off by defining the macro GLIB_DISABLE_DEPRECATION_WARNINGS before including the glib.h header.

GLib also provides support for building applications against defined subsets of deprecated or new GLib APIs. Define the macro GLIB_VERSION_MIN_REQUIRED to specify up to what version of GLib you want to receive warnings about deprecated APIs. Define the macro GLIB_VERSION_MAX_ALLOWED to specify the newest version of GLib whose API you want to use — this will result in deprecation warnings for any use in your application of API released in later GLib versions.

The macros GLIB_VERSION_2_2, GLIB_VERSION_2_4, …, GLIB_VERSION_2_80, etc. are defined automatically in each release, and can be used to set the value of macros like GLIB_VERSION_MIN_REQUIRED.

The macro G_ENCODE_VERSION() can be used to set the value of GLIB_VERSION_MAX_ALLOWED, as the relevant GLIB_VERSION_x_y macro will not be defined if building against a version of GLib which is at least GLIB_VERSION_MIN_REQUIRED but which is older than GLIB_VERSION_MAX_ALLOWED.

A typical way to define these macros in Meson is:

add_project_arguments([
    '-DGLIB_VERSION_MIN_REQUIRED=GLIB_VERSION_2_82',
    '-DGLIB_VERSION_MAX_ALLOWED=(G_ENCODE_VERSION(2,84))',
  ],
  language: 'c',
)

The macros GLIB_VERSION_CUR_STABLE and GLIB_VERSION_PREV_STABLE are also automatically defined to point to the right version definitions.