- 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