Cursor (SortedRecordset function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
 
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Template:SortedRecordset:Cursor subtitle}}


<span class="pageSubtitle"><section begin=dpl_desc/><section end=dpl_desc/></span>
[[Category:SortedRecordset methods|Cursor constructor]]
<p>
<var>Cursor</var> is a member of the <var>[[SortedRecordset class|SortedRecordset]]</var> class.
</p>
Instantiates a <var>RecordsetCursor</var> object for a
particular instance of a <var>SortedRecordset</var> object.
==Syntax==
==Syntax==
<p class="syntax">%rscursor = %srecs:Cursor
{{Template:SortedRecordset:Cursor syntax}}
</p>
===Syntax terms===
===Syntax terms===
<table class="syntaxTable">
<table class="syntaxTable">
<tr><th>%rscursor</th>
<tr><th>%recordsetCursor</th>
<td>A declared <var>RecordsetCursor</var> object, to which <var>Cursor</var> returns an instance of a <var>RecordsetCursor</var> object, if ''%srecs'' has at least one record. If ''%srecs'' has no records, <var>Cursor</var> returns a <var>Null</var> object.
<td>A declared <var>RecordsetCursor</var> object, to which <var>Cursor</var> returns an instance of a <var>RecordsetCursor</var> object, if <var class="term">sortedRecordset</var> has at least one record. If <var class="term">sortedRecordset</var> has no records, <var>Cursor</var> returns a <var>Null</var> object.
</td></tr>
</td></tr>
<tr><th>%srecs</th>
<tr><th>sortedRecordset</th>
<td>A reference to an instance of a <var>SortedRecordset</var> object.
<td>A reference to an instance of a <var>SortedRecordset</var> object.


</td></tr></table>
</td></tr></table>
==Usage Notes==
==Usage notes==
<ul>
<ul>
<li>You can have as many cursors as you want for a record set.
<li>You can have as many cursors as you want for a record set.
Line 29: Line 21:
positioned on the first record in the set.
positioned on the first record in the set.
</ul>
</ul>
==See also==
{{Template:SortedRecordset:Cursor footer}}

Latest revision as of 01:32, 29 April 2011

Instantiate a RecordsetCursor for this SortedRecordset (SortedRecordset class)


Syntax

%recordsetCursor = sortedRecordset:Cursor

Syntax terms

%recordsetCursor A declared RecordsetCursor object, to which Cursor returns an instance of a RecordsetCursor object, if sortedRecordset has at least one record. If sortedRecordset has no records, Cursor returns a Null object.
sortedRecordset 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.

See also