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 ...