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.