head 1.2; access; symbols RPM_4_2_1:1.1.1.5 RPM_4_2:1.1.1.5 RPM_4_1_1:1.1.1.5 RPM_4_1:1.1.1.4 RPM_4_0_5:1.1.1.3 RPM_4_0_4:1.1.1.2 RPM_4_0_3:1.1.1.1 RPM:1.1.1; locks; strict; comment @# @; 1.2 date 2008.01.02.09.52.52; author rse; state dead; branches; next 1.1; commitid z4cpSiAhOCXk5PLs; 1.1 date 2001.07.23.20.45.36; author rse; state Exp; branches 1.1.1.1; next ; 1.1.1.1 date 2001.07.23.20.45.36; author rse; state Exp; branches; next 1.1.1.2; 1.1.1.2 date 2002.01.08.00.30.08; author rse; state Exp; branches; next 1.1.1.3; 1.1.1.3 date 2003.01.18.13.48.55; author rse; state Exp; branches; next 1.1.1.4; 1.1.1.4 date 2001.07.23.20.09.12; author rse; state Exp; branches; next 1.1.1.5; 1.1.1.5 date 2003.01.18.14.04.56; author rse; state Exp; branches; next ; desc @@ 1.2 log @remove the ancient RPM 4.2.1 source tree copy @ text @ Berkeley DB: DBT

DBT: Bulk Retrieval

 APIRef

If either of the DB_MULTIPLE or DB_MULTIPLE_KEY flags were specified to the DB->get or DBcursor->c_get functions, the data DBT returned by those interfaces will refer to a buffer that is filled with data. Access to that data is through the following macros:

DB_MULTIPLE_INIT
DB_MULTIPLE_INIT(void *pointer, DBT *data);

Initialize the retrieval. The pointer argument is a variable to be initialized. The data argument is a DBT structure returned from a successful call to DB->get or DBcursor->c_get for which one of the DB_MULTIPLE or DB_MULTIPLE_KEY flags was specified.

DB_MULTIPLE_NEXT
DB_MULTIPLE_NEXT(void *pointer, DBT *data, void *retdata, size_t retdlen);

The data argument is a DBT structure returned from a successful call to DB->get or DBcursor->c_get for which the DB_MULTIPLE flag was specified. The pointer and data arguments must have been previously initialized by a call to DB_MULTIPLE_INIT. The retdata argument is set to refer to the next data element in the returned set, and the retdlen argument is set to the length, in bytes, of that data element. When used with the Queue and Recno access methods, retdata will be set to NULL for deleted records. The pointer argument is set to NULL if there are no more data elements in the returned set.

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

The data argument is a DBT structure returned from a successful call to DB->get or DBcursor->c_get for which the DB_MULTIPLE_KEY flag was specified. The pointer and data arguments must have been previously initialized by a call to DB_MULTIPLE_INIT. The retkey argument is set to refer to the next key element in the returned set, and the retklen argument is set to the length, in bytes, of that key element. The retdata argument is set to refer to the next data element in the returned set, and the retdlen argument is set to the length, in bytes, of that data element. The pointer argument is set to NULL if there are no more key/data pairs in the returned set.

DB_MULTIPLE_RECNO_NEXT
DB_MULTIPLE_RECNO_NEXT(void *pointer, DBT *data,
	db_recno_t recno, void * retdata, size_t retdlen);

The data argument is a DBT structure returned from a successful call to DB->get or DBcursor->c_get for which the DB_MULTIPLE_KEY flag was specified. The pointer and data arguments must have been previously initialized by a call to DB_MULTIPLE_INIT. The recno argument is set to the record number of the next record in the returned set. The retdata argument is set to refer to the next data element in the returned set, and the retdlen argument is set to the length, in bytes, of that data element. When used with the Queue and Recno access methods, retdata will be set to NULL for deleted records. The pointer argument is set to NULL if there are no more key/data pairs in the returned set.


APIRef

Copyright Sleepycat Software @ 1.1 log @Initial revision @ text @d1 1 a1 1 @ 1.1.1.1 log @Import: RPM 4.0.3 @ text @@ 1.1.1.2 log @Import: RPM 4.0.4 @ text @d1 1 a1 1 @ 1.1.1.3 log @Import: RPM 4.0.5 @ text @d1 2 a2 2 a3 1 d22 3 a24 3

If either of the DB_MULTIPLE or DB_MULTIPLE_KEY flags were specified to the DB->get or DBcursor->c_get methods, the data DBT returned by those interfaces will refer to a buffer that d28 1 a28 1

DB_MULTIPLE_INIT
DB_MULTIPLE_INIT(void *pointer, DBT *data);
d30 1 a30 1 to be initialized. The data argument is a DBT structure d32 1 a32 1 for which one of the DB_MULTIPLE or DB_MULTIPLE_KEY d34 2 a35 2

DB_MULTIPLE_NEXT
DB_MULTIPLE_NEXT(void *pointer, DBT *data, void *retdata, size_t retdlen);

The data argument is a DBT structure returned from a d37 1 a37 1 DB_MULTIPLE flag was specified. The pointer and d46 1 a46 1

DB_MULTIPLE_KEY_NEXT
DB_MULTIPLE_KEY_NEXT(void *pointer, DBT *data,
d48 1
a48 1

The data argument is a DBT structure returned from a
d50 1
a50 1
DB_MULTIPLE_KEY flag was specified.  The pointer and
d60 1
a60 1

DB_MULTIPLE_RECNO_NEXT
DB_MULTIPLE_RECNO_NEXT(void *pointer, DBT *data,
d62 1
a62 1

The data argument is a DBT structure returned from a
d64 1
a64 1
DB_MULTIPLE_KEY flag was specified.  The pointer and
@


1.1.1.4
log
@Import: RPM 4.1
@
text
@d1 2
a2 2


d4 1
d23 3
a25 3

If either of the DB_MULTIPLE or DB_MULTIPLE_KEY flags
were specified to the DB->get or DBcursor->c_get functions, the data
DBT returned by those interfaces will refer to a buffer that
d29 1
a29 1

DB_MULTIPLE_INIT
DB_MULTIPLE_INIT(void *pointer, DBT *data);

d31 1
a31 1
to be initialized.  The data argument is a DBT structure
d33 1
a33 1
for which one of the DB_MULTIPLE or DB_MULTIPLE_KEY
d35 2
a36 2

DB_MULTIPLE_NEXT
DB_MULTIPLE_NEXT(void *pointer, DBT *data, void *retdata, size_t retdlen);


The data argument is a DBT structure returned from a
d38 1
a38 1
DB_MULTIPLE flag was specified.  The pointer and
d47 1
a47 1

DB_MULTIPLE_KEY_NEXT
DB_MULTIPLE_KEY_NEXT(void *pointer, DBT *data,
d49 1
a49 1

The data argument is a DBT structure returned from a
d51 1
a51 1
DB_MULTIPLE_KEY flag was specified.  The pointer and
d61 1
a61 1

DB_MULTIPLE_RECNO_NEXT
DB_MULTIPLE_RECNO_NEXT(void *pointer, DBT *data,
d63 1
a63 1

The data argument is a DBT structure returned from a
d65 1
a65 1
DB_MULTIPLE_KEY flag was specified.  The pointer and
@


1.1.1.5
log
@Import: RPM 4.1.1
@
text
@d1 2
a2 2


a3 1

d22 3
a24 3

If either of the DB_MULTIPLE or DB_MULTIPLE_KEY flags
were specified to the DB->get or DBcursor->c_get methods, the data
DBT returned by those interfaces will refer to a buffer that
d28 1
a28 1

DB_MULTIPLE_INIT
DB_MULTIPLE_INIT(void *pointer, DBT *data);

d30 1
a30 1
to be initialized.  The data argument is a DBT structure
d32 1
a32 1
for which one of the DB_MULTIPLE or DB_MULTIPLE_KEY
d34 2
a35 2

DB_MULTIPLE_NEXT
DB_MULTIPLE_NEXT(void *pointer, DBT *data, void *retdata, size_t retdlen);


The data argument is a DBT structure returned from a
d37 1
a37 1
DB_MULTIPLE flag was specified.  The pointer and
d46 1
a46 1

DB_MULTIPLE_KEY_NEXT
DB_MULTIPLE_KEY_NEXT(void *pointer, DBT *data,
d48 1
a48 1

The data argument is a DBT structure returned from a
d50 1
a50 1
DB_MULTIPLE_KEY flag was specified.  The pointer and
d60 1
a60 1

DB_MULTIPLE_RECNO_NEXT
DB_MULTIPLE_RECNO_NEXT(void *pointer, DBT *data,
d62 1
a62 1

The data argument is a DBT structure returned from a
d64 1
a64 1
DB_MULTIPLE_KEY flag was specified.  The pointer and
@