State (RecordsetCursor function)

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

State is a member of the RecordsetCursor class.

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

Syntax

%cstate = %rscursor: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 ...