Method

GrlSourcesearch_sync

since: 0.2.0

Declaration [src] 

GList*
grl_source_search_sync (
  GrlSource* source,
  const gchar* text,
  const GList* keys,
  GrlOperationOptions* options,
  GError** error
)

Description [src]

Search for the text string in a source for data identified with that string.

If text is NULL then no text filter will be applied, and thus, no media items from source will be filtered. If source does not support NULL-text search operations it should notiy the client by setting GRL_CORE_ERROR_SEARCH_NULL_UNSUPPORTED in the error parameter.

This method is synchronous.

Available since: 0.2.0

Parameters

text

Type: const gchar*

The text to search.

The data is owned by the caller of the method.
The value is a NUL terminated UTF-8 string.
keys

Type: A list of None

The GList of GrlKeyIDs to request.

The data is owned by the caller of the method.
options

Type: GrlOperationOptions

Options wanted for that operation.

The data is owned by the caller of the method.
error

Type: GError **

The return location for a recoverable error.

The argument can be NULL.
If the return location is not NULL, then you must initialize it to a NULL GError*.
The argument will be left initialized to NULL by the method if there are no errors.
In case of error, the argument will be set to a newly allocated GError; the caller will take ownership of the data, and be responsible for freeing it.

Return value

Type: A list of GrlMedia*

A GList with GrlMedia elements. After use g_object_unref() every element and g_list_free() the list.

The caller of the method takes ownership of the data, and is responsible for freeing it.