Name: revCloseCursor

Type: command

Syntax: revCloseCursor <recordSetID>

Summary:
Closes a <redcord set|record set (database cursor)>.

Associations: database library

Introduced: 2.0

OS: mac, windows, linux, ios, android

Platforms: desktop, server, mobile

Security: disk, network

Example:
revCloseCursor 3

Example:
revCloseCursor finalResults

Parameters:
recordSetID:
The number returned by the revQueryDatabase function when the record set
was created.

The result:
If the closure is not successful, the result is set to an error message.

Description:
Use the <revCloseCursor> <command> to clean up after using a 
<record set> in a <database>.

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.

>*Important:*  The <revCloseCursor> <command> is part of the 
> <Database library>. To ensure that the <command> works in a 
> <standalone application>, you must include this 
> <LiveCode custom library|custom library> when you create your 
> <standalone application|standalone>. In the Inclusions pane of the 
> <Standalone Application Settings> window, make sure both the 
> "Database" library checkbox and those of the database drivers you are 
> using are checked.

References: revCloseDatabase (command), revDatabaseCursors (function),
revdb_disconnect (function), revQueryDatabase (function),
revDataFromQuery (function), revdb_closecursor (function),
Standalone Application Settings (glossary), database (glossary),
standalone application (glossary),
record set (glossary), command (glossary),
LiveCode custom library (glossary), Database library (library)

Tags: database

