Function lmdb_master_sys::mdb_cursor_renew

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

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.