Berkeley DB

Db::cursor

						#include <db_cxx.h>
						int
						Db::cursor(DbTxn *txnid, Dbc **cursorp, u_int32_t flags);
					

Description

The Db::cursor method creates a cursor and copies a pointer to it into the memory referenced by cursorp.

If the operation is to be transactionally protected, the txnid parameter is a transaction handle returned from DbEnv::txn_begin; otherwise, NULL.

To transaction-protect cursor operations, cursors must be opened and closed within the context of a transaction, and the txnid parameter specifies the transaction context in which the cursor may be used.

The flags value must be set to 0 or by bitwise inclusively OR’ing together one or more of the following values.

• DB_WRITECURSOR Specify that the cursor will be used to update the database. ...