dup_query_contacts


Description:

[ Version ( since = "3.50" ) ]
public bool dup_query_contacts (string? sexp, ContactField sort_field, BookCursorSortType sort_type, uint n_offset, uint n_limit, owned GenericArray<unowned Contact> out_contacts, Cancellable? cancellable = null) throws Error

Queries the this 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.

Parameters:

this

an BookSqlite

sexp

search expression; use null or an empty string to consider all stored contacts

sort_field

a field to sort by, which should be in the summary

sort_type

an BookCursorSortType

n_offset

a 0-based offset in the sorted result to start reading from, or 0 to read from start

n_limit

how many values to return only; use 0 or G_MAXUINT to read everything from the n_offset

out_contacts

an array of Contact-s in the requested order

cancellable

A Cancellable

Returns:

Whether succeeded.