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.

See also

RecordsetCursor class	List of RecordsetCursor methods	RecordsetCursor methods syntax
Notation conventions for methods