Next (RecordsetCursor function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (1 revision)
(No difference)

Revision as of 22:48, 26 April 2011

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