函数

GioDesktopAppInfosearch

声明 [src]

gchar***
g_desktop_app_info_search (
  const gchar* search_string
)

描述 [src]

搜索匹配 search_string 的桌面文件。

返回值是一个 strvs 数组。每个 strv 包含与 search_string 匹配且得分相同的应用列表。外层列表按得分排序，其中第一个 strv 包含最佳匹配的应用，依此类推。确定匹配的算法未定义，可能随时更改。

搜索结果均未接受 g_desktop_app_info_new() (例如，检查结果的引用的可执行文件是否存在) 执行的正常验证检查，因此 g_desktop_app_info_new() 在传入由该函数返回的应用程序 ID 后可能返回 NULL。预期调用代码将在随后为每个结果创建一个 GDesktopAppInfo 时执行此操作。

参数

search_string

类型： const gchar*

要使用的搜索字符串。

数据归函数的调用者所有。

值是一个以 NUL 结尾的 UTF-8 字符串。

返回值

类型： 一个空的数组

一个 strvs 列表。使用 g_strfreev() 释放每个项目，并使用 g_free() 释放外层列表。

数组以 NULL 结尾。

函数的调用者承担数据的所有权，并负责释放它。