Function

Gtkcheck_version

Declaration [src]

const gchar*
gtk_check_version (
  guint required_major,
  guint required_minor,
  guint required_micro
)

Description [src]

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

Type: guint

The required major version.

required_minor

Type: guint

The required minor version.

required_micro

Type: guint

The required micro version.

Return value

Type: const gchar*

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.

The data is owned by the called function.

The return value can be NULL.

The value is a NUL terminated UTF-8 string.