chickadee » lmdb-lolevel » mdb-cursor-renew

mdb-cursor-renew txn cursorprocedure

Renew a cursor handle.

A cursor is associated with a specific transaction and database. Cursors that are only used in read-only transactions may be re-used, to avoid unnecessary malloc/free overhead. The cursor may be associated with a new read-only transaction, and referencing the same database handle as it was created with. This may be done whether the previous transaction is live or dead.

A transaction handle returned by (mdb-txn-begin)
A cursor handle returned by (mdb-cursor-open)

Some possible error conditions:

(exn lmdb EINVAL)
an invalid parameter was specified.