Next (RecordsetCursor function): Difference between revisions
Jump to navigation
Jump to search
m (Created page with "<span class="pageSubtitle"><section begin=dpl_desc/><section end=dpl_desc/></span> Next function <p> <var>Next</var> is a member of the <var>...") |
m (→Syntax terms) |
||
| Line 15: | Line 15: | ||
<table class="syntaxTable"> | <table class="syntaxTable"> | ||
<tr><th>%cstate</th> | <tr><th>%cstate</th> | ||
<td>If specified, a declared enumeration object of type <var>CursorState</var> to contain the state of the cursor after the completion of <var>Next</var>. Valid values are described in [[RecordsetCursor#Cursor state|"Cursor state"]]. | <td>If specified, a declared enumeration object of type <var>CursorState</var> to contain the state of the cursor after the completion of <var>Next</var>. Valid values are described in [[RecordsetCursor class#Cursor state|"Cursor state"]]. | ||
</td></tr> | </td></tr> | ||
<tr><th>%rscursor</th> | <tr><th>%rscursor</th> | ||
| Line 21: | Line 21: | ||
</td></tr></table> | </td></tr></table> | ||
==Usage Notes== | ==Usage Notes== | ||
<ul> | <ul> | ||
Revision as of 21:22, 26 April 2011
<section begin=dpl_desc/><section end=dpl_desc/>
Next is a member of the 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
[%cstate =] %rscursor: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.