Method type for #EDataBookCursorClass.get_position()
Cursor implementations must implement this to count the total results
matching cursor's query expression and to calculate the amount of contacts
leading up to the current cursor state (cursor inclusive).
A cursor position is defined as an integer which is inclusive of the
current contact to which it points (if the cursor points to an exact
contact). A position of 0 indicates that the cursor is situated in
a position that is before and after the entire result set. The cursor
position should be 0 at creation time, and should start again from
the symbolic 0 position whenever %E_BOOK_CURSOR_ORIGIN_BEGIN is
specified in the #EDataBookCursorClass.step() method (or whenever
moving the cursor beyond the end of the result set).
If the cursor is positioned beyond the end of the list, then
the position should be the total amount of contacts available
in the list (as returned through the total argument) plus one.
This method is called by e_data_book_cursor_recalculate() and in some
other cases where cursor's current position and total must be
recalculated from scratch.
Method type for #EDataBookCursorClass.get_position()
Cursor implementations must implement this to count the total results matching
cursor's query expression and to calculate the amount of contacts leading up to the current cursor state (cursor inclusive).A cursor position is defined as an integer which is inclusive of the current contact to which it points (if the cursor points to an exact contact). A position of 0 indicates that the cursor is situated in a position that is before and after the entire result set. The cursor position should be 0 at creation time, and should start again from the symbolic 0 position whenever %E_BOOK_CURSOR_ORIGIN_BEGIN is specified in the #EDataBookCursorClass.step() method (or whenever moving the cursor beyond the end of the result set).
If the cursor is positioned beyond the end of the list, then the position should be the total amount of contacts available in the list (as returned through the
totalargument) plus one.This method is called by e_data_book_cursor_recalculate() and in some other cases where
cursor's current position and total must be recalculated from scratch.