KDE 4.2 API Reference akregator
c4_Cursor Class Reference
#include <mk4.h>
Detailed Description
An iterator for collections of rows (views).Cursor objects can be used to point to specific entries in a view. A cursor acts very much like a pointer to a row in a view, and is returned when taking the address of a c4_RowRef. Dereferencing a cursor leads to the original row reference again. You can construct a cursor for a c4_Row, but since such rows are not part of a collection, incrementing or decrementing these cursors is meaningless (and wrong).
The usual range of pointer operations can be applied to these objects: pre/post-increment and decrement, adding or subtracting integer offsets, as well as the full range of comparison operators. If two cursors point to entries in the same view, their difference can be calculated.
As with regular pointers, care must be taken to avoid running off of either end of a view (the debug build includes assertions to check this).
Definition at line 364 of file mk4.h.
Constructor & Destructor Documentation
| c4_Cursor::c4_Cursor | ( | c4_Sequence & | , | |
| int | ||||
| ) |
Construct a new cursor.
Member Function Documentation
| c4_RowRef c4_Cursor::operator * | ( | ) | const |
Dereference this cursor to "almost" a row.
| c4_Cursor c4_Cursor::operator++ | ( | int | ) |
Post-increment the cursor.
| c4_Cursor& c4_Cursor::operator++ | ( | ) |
Pre-increment the cursor.
| c4_Cursor& c4_Cursor::operator+= | ( | int | ) |
Advance by a given offset.
| int c4_Cursor::operator- | ( | c4_Cursor | ) | const |
Return the distance between two cursors.
| c4_Cursor c4_Cursor::operator- | ( | int | ) | const |
Subtract a specified offset.
| c4_Cursor c4_Cursor::operator-- | ( | int | ) |
Post-decrement the cursor.
| c4_Cursor& c4_Cursor::operator-- | ( | ) |
Pre-decrement the cursor.
| c4_Cursor& c4_Cursor::operator-= | ( | int | ) |
Back up by a given offset.
| c4_RowRef c4_Cursor::operator[] | ( | int | ) | const |
This is the same as *(cursor + offset).
Friends And Related Function Documentation
Return true if the contents of both rows are not equal.
True if first row is less than second row.
True if first row is less or equal to second row.
True if first cursor is less or equal to second cursor.
Return true if the contents of both rows are equal.
True if first row is greater than second row.
True if first cursor is greater than second cursor.
True if first row is greater or equal to second row.
True if first cursor is greater or equal to second cursor.
Member Data Documentation
The documentation for this class was generated from the following file:
