Function
GioUnixDesktopAppInfosearch
Declaration [src]
gchar***
g_desktop_app_info_search (
const gchar* search_string
)
Description [src]
Searches desktop files for ones that match search_string.
The return value is an array of strvs. Each strv contains a list of
applications that matched search_string with an equal score. The
outer list is sorted by score so that the first strv contains the
best-matching applications, and so on.
The algorithm for determining matches is undefined and may change at
any time.
None of the search results are subjected to the normal validation
checks performed by g_desktop_app_info_new() (for example, checking that
the executable referenced by a result exists), and so it is possible for
g_desktop_app_info_new() to return NULL when passed an app ID returned
by this function. It is expected that calling code will do this when
subsequently creating a GDesktopAppInfo for each result.
Parameters
search_string-
Type:
const gchar*The search string to use.
The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string.
Return value
Type: An array of void
A
list of strvs. Free each item with g_strfreev() and free the outer
list with g_free().
The array is NULL-terminated. |
| The caller of the function takes ownership of the data, and is responsible for freeing it. |