函数

GioIOModulequery

自:2.24

声明 [src]

char**
g_io_module_query (
  void
)

描述 [src]

GIO模块实现的可选API

应返回所有可能在此模块中实现的扩展点的列表。

此方法在正常使用中不会调用,但在探测现有模块和记录此模型使用的扩展点时可能会调用。这意味着除非需要,否则我们不必加载和初始化此模块。

如果模块没有实现此函数,则模块将在应用程序启动时始终加载、初始化然后卸载,以便在初始化期间注册其扩展点。

请注意,模块不需要实际实现 g_io_module_query() 返回的扩展点,因为实际的扩展点列表可能取决于运行时问题。但是,所有实际实现的扩展点都必须通过 g_io_module_query() 返回(如果已定义)。

安装实现 g_io_module_query() 的模块时,必须运行 gio-querymodules 以构建所需用于延迟加载的缓存文件。

自2.56以来,此函数应命名为 g_io__query,其中 modulename 是插件文件名,具有 liblibgio 前缀,删除第一个点之后的所有内容,并且在整个名称中使用 - 替换为 _。例如,libgiognutls-helper.so 变为 gnutls_helper。使用新的符号名称可以避免在构建静态模块时的名称冲突。旧符号名称继续得到支持,但不能用于静态构建。

自:2.24

返回值

类型: utf8的数组

一个以空字符终止的字符串数组,列出模块支持的扩展点。此数组必须适合使用 g_strfreev() 释放。

数组以空字符终止。
函数的调用者对数据拥有所有权,并负责释放它。
每个元素都是一个以空字符终止的UTF-8字符串。