dup_view_contacts


Description:

[ Version ( since = "3.50" ) ]
public GenericArray<unowned Contact>? dup_view_contacts (size_t view_id, uint range_start, uint range_length)

Returns range_length contacts from 0-based index range_start in the view identified by the view_id .

When there are asked more than get_view_n_total contacts only those up to the total number of contacts are read. Asking for out of range contacts results in an error, though it can return less than range_length contacts.

The default implementation tracks the view's content in memory and returns the contacts as needed. The subclasses can do more efficient implementation.

Note: This function should be used only with E_BOOK_CLIENT_VIEW_FLAGS_MANUAL_QUERY views.

Parameters:

this

an BookBackend

view_id

a view identifier

range_start

0-based range start to retrieve the contacts for

range_length

how many contacts to retrieve

Returns:

an array of the contacts, or null, when the view cannot be found or when the range_start is out of bounds.