Berkeley DB Reference Guide: Access Methods

Storing records with a cursor

The DBcursor->c_put function is the standard interface for storing records into the database with a cursor. In general, DBcursor->c_put takes a key and inserts the associated data into the database, at a location controlled by a specified flag.

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

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 data part 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.

Copyright Sleepycat Software