page1
Brown, Charlie
Bunny, Bugs
Doo, Scooby
Mouse, Mickey
Simpson, Bart
Simpson, Homer
E_BOOK_CURSOR_ORIGIN_BEGIN
E_BOOK_CURSOR_ORIGIN_END
0
1
2
3
4
5
6
7
+4
Stepping four contacts from the initial position traverses four contacts, causing the cursor to point to the fourth contact.
Brown, Charlie
Bunny, Bugs
Doo, Scooby
Mouse, Mickey
Simpson, Bart
Simpson, Homer
E_BOOK_CURSOR_ORIGIN_BEGIN
E_BOOK_CURSOR_ORIGIN_END
0
1
2
3
4
5
6
7
While stepping in reverse starting from “Mickey Mouse”, “Scooby Doo” will be the first contact traversed and the cursor will land on “Charlie Brown”. Note how this differs from a file position, where an offset can only point to a position between data or records.
-3
Brown, Charlie
Bunny, Bugs
Doo, Scooby
Mouse, Mickey
Simpson, Bart
Simpson, Homer
E_BOOK_CURSOR_ORIGIN_BEGIN
E_BOOK_CURSOR_ORIGIN_END
0
1
2
3
4
5
6
7
Stepping forward by 4 contacts will land us outside of the list. Only Bart and Homer Simpson will be returned and the cursor will now point to the symbolic end position. Receiving less results than requested is not considered an error.
+4
Bunny, Bugs
Doo, Scooby
Mouse, Mickey
Simpson, Bart
Simpson, Homer
E_BOOK_CURSOR_ORIGIN_END
2
3
4
5
6
7
When the cursor is positioned at the symbolic end position, moving the cursor forwards triggers a query refused error. The same applies when moving in reverse from the symbolic begin position.
The cursor state is unaffected by these refused requests.
E_CLIENT_ERROR_QUERY_REFUSED
+1
?