Cursor (SortedRecordset function)

From m204wiki
Jump to navigation Jump to search

<section begin=dpl_desc/><section end=dpl_desc/>

Cursor is a member of the SortedRecordset class.

Instantiates a RecordsetCursor object for a particular instance of a SortedRecordset object.

Syntax

%rscursor = %srecs:Cursor

Syntax terms

%rscursor A declared RecordsetCursor object, to which Cursor returns an instance of a RecordsetCursor object, if %srecs has at least one record. If %srecs has no records, Cursor returns a Null object.
%srecs A reference to an instance of a SortedRecordset object.

Usage Notes

  • You can have as many cursors as you want for a record set.
  • To test for an empty record set, use IsEmpty, which is much more efficient than testing the record Count for 0.
  • The instantiated RecordsetCursor is automatically positioned on the first record in the set.