<doc>
  <legacy_id>1379</legacy_id>
  <name>revCloseCursor</name>
  <type>command</type>
  <syntax>
    <example>revCloseCursor <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="revDatabaseCursors">revDatabaseCursors Function</function>
    <command tag="revCloseDatabase">revCloseDatabase Command</command>
    <function tag="revQueryDatabase">revQueryDatabase Function</function>
    <function tag="revdb_closecursor">revdb_closecursor Function</function>
    <function tag="revDataFromQuery">revDataFromQuery Function</function>
    <function tag="revdb_disconnect">revdb_disconnect 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>Closes a <glossary tag="record set (database cursor)">record set (database cursor)</glossary>.</summary>
  <examples>
    <example>revCloseCursor 3</example>
    <example>revCloseCursor finalResults</example>
  </examples>
  <description>
    <p>Use the <b>revCloseCursor</b> <glossary tag="command">command</glossary> to clean up after using a <glossary tag="record set (database cursor)">record set</glossary> in a <glossary tag="database">database</glossary>.</p><p/><p><b>Parameters:</b></p><p>The <i>recordSetID</i> is the number returned 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>All open record sets are closed automatically when the database they are associated with is closed. However, it is recommended practice to explicitly close record sets when your stack is finished with them.</p><p/><p>If the closure is not successful, the <b>result</b> is set to an error message.</p><p/><p><img src="202653"/> <b>Important!</b> The <b>revCloseCursor </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>