Method
EDataBookBookCachedup_query_contacts
since: 3.50
Declaration [src]
gboolean
e_book_cache_dup_query_contacts (
EBookCache* book_cache,
const gchar* sexp,
EContactField sort_field,
EBookCursorSortType sort_type,
guint n_offset,
guint n_limit,
GPtrArray** out_contacts,
GCancellable* cancellable,
GError** error
)
Description [src]
Queries the book_cache for the contacts in the given range and order. The sort_field should be in the summary, otherwise an error
is returned.
Free the out_contacts with g_ptr_aray_unref(), when no longer needed.
Available since: 3.50
Parameters
sexp-
Type:
const gchar*Search expression; use
NULLor an empty string to consider all stored contacts.The argument can be NULL.The data is owned by the caller of the method. The value is a NUL terminated UTF-8 string. sort_field-
Type:
EContactFieldA field to sort by, which should be in the summary.
sort_type-
Type:
EBookCursorSortTypeAn
EBookCursorSortType. n_offset-
Type:
guintA 0-based offset in the sorted result to start reading from, or 0 to read from start.
n_limit-
Type:
guintHow many values to return only; use 0 or G_MAXUINT to read everything from the
n_offset. out_contacts-
Type: An array of
EContact*An array of
EContact-s in the requested order.The instance takes ownership of the data container, but not the data inside it. cancellable-
Type:
GCancellableA
GCancellable.The argument can be NULL.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 aNULLGError*.The argument will be left initialized to NULLby 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.