Library Version 12.1.6.1

DB_MULTIPLE_KEY_NEXT
Prev | Chapter 4. The DBT Handle | Next

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

Prev | Up | Next
DB_MULTIPLE_NEXT | Home | DB_MULTIPLE_RECNO_NEXT