<doc>
  <legacy_id>1040</legacy_id>
  <name>revMoveToNextRecord</name>
  <type>command</type>
  <syntax>
    <example>revMoveToNextRecord <i>recordSetID</i></example>
  </syntax>
  <library>Database library</library>
  <objects>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
    <category>Database Operations</category>
    <category>Standalone Applications</category>
  </classification>
  <references>
    <function tag="revCurrentRecord">revCurrentRecord Function</function>
    <function tag="revCurrentRecordIsFirst">revCurrentRecordIsFirst Function</function>
    <function tag="revCurrentRecordIsLast">revCurrentRecordIsLast Function</function>
    <command tag="revMoveToFirstRecord">revMoveToFirstRecord Command</command>
    <command tag="revMoveToPreviousRecord">revMoveToPreviousRecord Command</command>
    <function tag="revNumberOfRecords">revNumberOfRecords Function</function>
    <command tag="revMoveToLastRecord">revMoveToLastRecord Command</command>
    <command tag="revMoveToRecord">revMoveToRecord Command</command>
    <function tag="revdb_movefirst">revdb_movefirst Function</function>
    <function tag="revDatabaseColumnNumbered">revDatabaseColumnNumbered Function</function>
    <function tag="revdb_moveprev">revdb_moveprev Function</function>
    <function tag="revdb_movelast">revdb_movelast Function</function>
    <function tag="revdb_movenext">revdb_movenext Function</function>
    <function tag="revQueryIsAtEnd">revQueryIsAtEnd Function</function>
  </references>
  <history>
    <introduced version="2.0">Added.</introduced>
  </history>
  <platforms>
    <mac/>
    <windows/>
    <linux/>
    <ios/>
    <android/>
  </platforms>
  <classes>
    <desktop/>
    <server/>
    <web/>
    <mobile/>
  </classes>
  <security>
    <disk access="???"/>
    <network/>
  </security>
  <summary>
    <p>Moves to the next <glossary tag="record">record</glossary> in a <glossary tag="record set (database cursor)">record set (database cursor)</glossary>.</p>
  </summary>
  <examples>
    <example>revMoveToNextRecord myCurrentItems</example>
    <example>revMoveToNextRecord (line x of field "Current Recordsets")</example>
  </examples>
  <description>
    <p>Use the <b>revMoveToNextRecord</b> <glossary tag="command">command</glossary> to move around within the selected set of <glossary tag="record">records</glossary>.</p><p/><p><b>Parameters:</b></p><p>The <i>recordSetID</i> is the number <glossary tag="return">returned</glossary> by the <function tag="revQueryDatabase">revQueryDatabase function</function> when the <glossary tag="record set (database cursor)">record set</glossary> was created.</p><p/><p><b>Comments:</b></p><p>If the command could not move to the next record because it's already at the end or there are no records in the record set, the <b>result</b> <control_st tag="function">function</control_st> returns false.</p><p/><p><b>Note:</b> Not all <glossary tag="database">databases</glossary> support the <b>revMoveToNextRecord</b> <glossary tag="command">command</glossary>. All the major database types that LiveCode can connect to do support this, however certain ODBC data sources may not, if in doubt, refer to the documentation for your ODBC data source driver.</p><p/><p><img src="202653"/> <b>Important!</b> The <b>revMoveToNextRecord</b> <glossary tag="command">command</glossary> is part of the <glossary tag="Database library">Database library</glossary>. To ensure that the <glossary tag="command">command</glossary> works in a <glossary tag="standalone application">standalone application</glossary>, you must include this <glossary tag="LiveCode custom library">custom library</glossary> when you create your <glossary tag="standalone application">standalone</glossary>. In the Inclusions section of the General screen of the <glossary tag="Standalone Application Settings">Standalone Application Settings</glossary> window, make sure the "Database Support" checkbox is checked and the database drivers you are using are selected in the list of database drivers.</p>
  </description>
</doc>