State (RecordsetCursor function)

Return current state of RecordSetCursor (RecordsetCursor class)

This read-only method returns the current state of the cursor.

Syntax

%cursorState = recordsetCursor:State

Syntax terms

%cstate	If specified, a declared enumeration object of type CursorState to contain the returned value of State. Possible values are BeforeStart, HasRecord, AfterEnd, NoRecord, and Empty, as described in "Cursor state".
%rscursor	An instantiated RecordsetCursor object.

Example

The following fragment suggests a way to use the State property with a cursor object:

%rs is object recordSet in file myfile %srecs is object SortedRecordset in file myfile %myCursor is object RecordsetCursor in file myfile ... fd to %rs end find ... sort records in %rs to %srecs by name ... %myCursor = %srecs:Cursor fr in %srecs ... repeat while ( %myCursor:State = hasrecord ) end for ...

See also

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