#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.
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.
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.