[ 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