Next (RecordsetCursor function)
Move cursor to the next record in the set (RecordsetCursor class)
This callable
method positions the cursor on the “next” record in the set,
and it returns a CursorState enumeration
indicating the state of the cursor after the operation.
Syntax
[%cursorState =] recordsetCursor:Next
Syntax terms
| %cstate | If specified, a declared enumeration object of type CursorState to contain the state of the cursor after the completion of Next. Valid values are described in "Cursor state". |
|---|---|
| %rscursor | An instantiated RecordsetCursor object. |
Usage notes
- Next may be issued if the cursor is in one of two states:
- HasRecord — Advances to the next record (if there is one).
- BeforeStart — Advances to the first record.
- If Next is called on a cursor whose state is AfterEnd, the request is cancelled.
- After issuing Next, the cursor is left in one of two states:
- HasRecord — The cursor moved to a new record, and it is ready to go.
- AfterEnd — The cursor ran off the end, and it points to no record.