DB_MULTIPLE_RECNO_NEXT

#include <db.h>

DB_MULTIPLE_RECNO_NEXT(void *pointer, DBT *data,
    db_recno_t recno, 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 Queue or Recno 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 Queue or Recno 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.

recno

The recno parameter is set to the record number of the next record in the returned set.

retdata

The retdata parameter is set to the next data element in the returned set. Deleted records are not included in the results.

retdlen

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

Class

DBT

See Also

DBT and Bulk Operations