函数

GioUnixDesktopAppInfosearch

声明 [src]

gchar***
g_desktop_app_info_search (
  const gchar* search_string
)

描述 [src]

搜索桌面文件，查找与 search_string 匹配的文件。

返回值是一个strv数组的数组。每个strv包含一个 listOf applications，它们与 search_string 具有相同的得分。外层列表按得分排序，因此第一个strv包含最佳匹配的应用程序，依此类推。匹配算法是未定义的，可能会随时更改。

搜索结果均未经过g_desktop_app_info_new() (例如，检查结果引用的可执行文件是否存在) 所执行的正常验证检查，因此当通过此函数返回的应用程序 ID 传递给 g_desktop_app_info_new() 时，可能会返回 NULL。预计调用代码将在创建每个结果的新 GDesktopAppInfo 时执行此操作。

参数

search_string

类型: const gchar*

要使用的搜索字符串。

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

值是一个以空字符终止的UTF-8字符串。

返回值

类型: 一个void的数组

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

数组是 NULL 终止的。

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