#include <db_cxx.h>

int
Dbc::count(db_recno_t *countp, u_int32_t flags);

The Dbc::count method returns a count of the number of data items for the key to which the cursor refers.

The Dbc::count 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 countp parameter references memory into which the count of the number of duplicate data items is copied.

• The flags parameter is currently unused, and must be set to 0.

The Dbc::count method may fail and throw DbException, encapsulating one of the following non-zero errors, or return one of the following non-zero errors:

• The database handle has been invalidated because a replication election unrolled a committed transaction.

• The operation was blocked by client/master synchronization.

• If the cursor has not been initialized; or if an invalid flag value or parameter was specified.