Description: Berkeley DB: An embedded database programmatic toolkit.
Keywords: embedded,database,programmatic,toolkit,b+tree,btr ee,hash,hashing,transaction,transactions,locking,logging,access method,access me thods,java,C,C++

### Berkeley DB Reference Guide: Access Methods

# Storing records with a cursor

The DBcursor->c_put function is the standard function for storing records into the database, with a cursor. In general, the cursor put function takes a key and inserts the associated data into the database.

There are several flags that you can set to customize retrieval:

DB_AFTER
  Create a new record, immediately after the record currently referenced by the cursor.

DB_BEFORE
  Create a new record, immediately before the record currently referenced by the cursor.

DB_CURRENT
  Replace the contents of the record currently referenced by the cursor.

DB_KEYFIRST
  Create a new record, as the first of the duplicate records for the supplied key.

DB_KEYLAST
  Create a new record, as the last of the duplicate records for the supplied key.

In all cases, the cursor is repositioned by a DBcursor->c_put operation to point to the newly inserted key/data pair in the database.