函数

Gtkcheck_version

声明 [src]

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

描述 [src]

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

通常,可以将常量 GTK_MAJOR_VERSIONGTK_MINOR_VERSIONGTK_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 字符串。