Chapter 3. The Dbc Handle
Prev |  | Next

## Chapter 3. The Dbc Handle

A Dbc object is a handle for a cursor into a Berkeley DB database.

Dbc handles are not free-threaded. Cursor handles may be shared by multiple threads if access is serialized by the application.

You create a Dbc using the Db::cursor() method.

If the cursor is to be used to perform operations on behalf of a transaction, the cursor must be opened and closed within the context of that single transaction.

Once Dbc::close() has been called, the handle may not be accessed again, regardless of the method's return.

## Database Cursors and Related Methods

Database Cursors and Related Methods | Description
--- | ---
Db::cursor() | Create a cursor handle
Dbc::close() | Close a cursor handle
Dbc::cmp() | Compare two cursors for equality.
Dbc::count() | Return count of duplicates for current key
Dbc::del() | Delete current key/data pair
Dbc::dup() | Duplicate the cursor handle
Dbc::get() | Retrieve by cursor
Dbc::put() | Store by cursor
Dbc::set_priority(), Dbc::get_priority() | Set/get the cursor's cache priority

Prev |  | Next
Db::verify() | Home | Db::cursor()