DB_MULTIPLE_KEY_NEXT

#include <db.h>

DB_MULTIPLE_KEY_NEXT(void *pointer, DBT *data,
    void *retkey, size_t retklen, void *retdata, size_t retdlen); 

If either of the DB_MULTIPLE or DB_MULTIPLE_KEY flags were specified to the DB->get() or DBcursor->get() methods, the data DBT returned by those interfaces will refer to a buffer that is filled with data. Access to that data is through the DB_MULTIPLE_* macros.

Returns the next DBT in the bulk retrieval set. Use this macro with DBT structures obtained from a database that uses the Btree or Hash access methods.

Parameters

pointer

The pointer parameter is a variable that must have been initialized by a call to DB_MULTIPLE_INIT.

This parameter is set to NULL if there are no more key/data pairs in the returned set.

data

The data parameter is a DBT structure returned from a successful call to DBcursor->get() with the Btree or Hash access methods for which the DB_MULTIPLE_KEY flag was specified.

The data parameter must have been initialized by a call to DB_MULTIPLE_INIT.

retkey

The retkey parameter is set to the next key element in the returned set.

retklen

The retklen parameter is set to the length, in bytes, of the next key element.

retdata

The retdata parameter is set to the next data element in the returned set.

retdlen

The retdlen parameter is set to the length, in bytes, of the next data element.

Class

DBT

See Also

DBT and Bulk Operations