Function mdb_cursor_renew

pub unsafe extern "C" fn mdb_cursor_renew(
    txn: *mut MDB_txn,
    cursor: *mut MDB_cursor,
) -> c_int

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.

Arguments

• txn (direction in) - A transaction handle returned by #mdb_txn_begin()
• cursor (direction in) - A cursor handle returned by #mdb_cursor_open()

Returns

A non-zero error value on failure and 0 on success. Some possible errors are:

• EINVAL - an invalid parameter was specified.