search_sync


Description:

public virtual bool search_sync (string? expr, bool meta_contact, out SList<Contact> out_contacts, Cancellable? cancellable = null) throws Error

Searches this with given expression expr and returns found contacts as a SList of Contact out_contacts.

Free the returned out_contacts with g_slist_free_full (contacts, g_object_unref); when no longer needed. When the expr is null, all objects are returned. To get UID-s instead, call search_uids_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

meta_contact

true, when return Contact filled with UID and REV only, false to return full contacts

out_contacts

return location for the found contacts as Contact

cancellable

optional Cancellable object, or null

Returns:

Whether succeeded.