Db::cursor
Db::cursor |
|
#include <db_cxx.h>int Db::cursor(DbTxn *txnid, Dbc **cursorp, u_int32_t flags);
The Db::cursor method creates a cursor and copies a pointer to it into the memory to which cursorp refers.
If the operation is to be transaction-protected, the txnid parameter is a transaction handle returned from DbEnv::txn_begin; otherwise, NULL.
To transaction-protect cursor operations, cursors must be opened and closed within the context of a transaction, and the txnid parameter specifies the transaction context in which the cursor may be used.
The flags value must be set to 0 or by bitwise inclusively OR'ing together one or more of the following values:
The Db::cursor method either returns a non-zero error value or throws an exception that encapsulates a non-zero error value on failure, and returns 0 on success.
The Db::cursor method may fail and throw an exception or return a non-zero error for the following conditions:
The Db::cursor method may fail and throw an exception or return a non-zero error for errors specified for other Berkeley DB and C library or system methods. If a catastrophic error has occurred, the Db::cursor method may fail and either return DB_RUNRECOVERY or throw an exception encapsulating DB_RUNRECOVERY, in which case all subsequent Berkeley DB calls will fail in the same way.
|
|
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
d17 1
a17 1
d110 1
a110 1
@
1.1.1.3
log
@Import: RPM 4.0.5
@
text
@d1 2
a2 2
a3 1
d56 4
a59 4
If a catastrophic error has occurred, the Db::cursor method may fail and
either return DB_RUNRECOVERY or throw a
DbRunRecoveryException,
in which case all subsequent Berkeley DB calls will fail in the same way.
d61 1
a61 1
Dbc
d63 45
a107 1
Database Cursors and Related Methods
@
1.1.1.4
log
@Import: RPM 4.1
@
text
@d1 2
a2 2
d4 1
d57 4
a60 4
If a catastrophic error has occurred, the Db::cursor method may fail and either
return DB_RUNRECOVERY or throw an exception encapsulating
DB_RUNRECOVERY, in which case all subsequent Berkeley DB calls will fail
in the same way.
d62 1
a62 1
Db
d64 1
a64 45
Db::associate,
Db::close,
Db::cursor,
Db::del,
Db::err, Db::errx
Db::fd,
Db::get,
Db::pget,
Db::get_byteswapped,
Db::get_type,
Db::join,
Db::key_range,
Db::open,
Db::put,
Db::remove,
Db::rename,
Db::set_alloc,
Db::set_append_recno,
Db::set_bt_compare,
Db::set_bt_minkey,
Db::set_bt_prefix,
Db::set_cachesize,
Db::set_dup_compare,
Db::set_errcall,
Db::set_errfile,
Db::set_errpfx,
Db::set_feedback,
Db::set_flags,
Db::set_h_ffactor,
Db::set_h_hash,
Db::set_h_nelem,
Db::set_lorder,
Db::set_pagesize,
Db::set_paniccall,
Db::set_q_extentsize,
Db::set_re_delim,
Db::set_re_len,
Db::set_re_pad,
Db::set_re_source,
Db::stat,
Db::sync,
Db::truncate,
Db::upgrade,
and
Db::verify.
@
1.1.1.5
log
@Import: RPM 4.1.1
@
text
@d1 2
a2 2
a3 1
d56 4
a59 4
If a catastrophic error has occurred, the Db::cursor method may fail and
either return DB_RUNRECOVERY or throw a
DbRunRecoveryException,
in which case all subsequent Berkeley DB calls will fail in the same way.
d61 1
a61 1
Dbc
d63 45
a107 1
Database Cursors and Related Methods
@