函数

Gtkcheck_version

声明 [src]

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

[−]

描述 [src]

检查正在使用的 GTK 库与给定版本兼容。

通常，可以将常量 GTK_MAJOR_VERSION、GTK_MINOR_VERSION、GTK_MICRO_VERSION 作为该函数的三个参数传递；它会检查正在使用的库是否与应用程序或模块编译时针对的 GTK 版本兼容。

兼容性由两件事定义：第一个正在运行的库版本比版本 required_major.required_minor.required_micro 新。其次，正在运行的库必须与版本 required_major.required_minor.required_micro（相同的主要版本）二进制兼容。

此函数主要用于 GTK 模块；模块可以调用此函数来检查它是否加载到不兼容的 GTK 版本中。然而，这样的检查并非完全可靠，因为该模块可能会链接到旧版本的 GTK 并调用旧版本的 gtk_check_version()，但仍然会被加载到使用较新版本的 GTK 的应用程序中。

[−]

参数

required_major

类型： guint

所需的主版本。

required_minor

类型： guint

所需次要版本。

required_micro

类型： guint

所需次要版本。

[−]

返回值

类型： const char*

如果 GTK 库与给定的版本兼容，则为 NULL，如果版本不匹配，则为描述版本不匹配的字符串。返回的字符串归 GTK 所有，不应修改它或释放它。

数据归调用的函数所有。

返回值可以为 NULL。

该值为以 NUL 结尾的 UTF-8 字符串。