search_uids_sync


Description:

public virtual bool search_uids_sync (string? expr, out SList<string> out_uids, Cancellable? cancellable = null) throws Error

Searches this with given expression expr and returns found contact UID-s as a SList out_contacts.

Free the returned out_uids with g_slist_free_full (uids, g_free); when no longer needed. When the expr is null, all UID-s are returned. To get Contact(s) instead, call search_sync.

It is optional to implement this virtual method by the descendant. The default implementation searches this 's cache. It's also not required to be online for searching, thus this doesn't ensure it.

Parameters:

this

an BookMetaBackend

expr

a search expression, or null

out_uids

return location for the found contact UID-s

cancellable

optional Cancellable object, or null

Returns:

Whether succeeded.