[ library(dbi) | Reference Manual | Alphabetic Index ]

# cursor_close(++Cursor)

Close the cursor associated with Cursor

Cursor
  A cursor handle

## Description

Closes a cursor explicitly, and frees the resources associated with the cursor. It takes effect immediately.

It is recommended that the user close all cursors before explicitly closing a session. Cursors that remain open after a session is closed cannot be used, but may still be using resources.

Cursors are automatically closed if the program backtracks or aborts back beyond where they were created.

### Exceptions

(5) type error
  Cursor is not a cursor handle.

## See Also

session_close / 1, session_sql_prepare / 4, session_sql_query / 4, session_sql_prepare_query / 5