Function

Gtk.check_version

Declaration [src]

const char*
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`	`guint`
	the required major version
`required_minor`	`guint`
	the required minor version
`required_micro`	`guint`
	the required micro version

Return value

Returns: `const char*`
`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
Can be `NULL`
The string is a NUL terminated UTF-8 string