DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

DBcursor->c_count

API Ref

#include <db.h>

int DBcursor->c_count(DBC *DBcursor, db_recno_t *countp, u_int32_t flags);


Description: DBcursor->c_count

The DBcursor->c_count method returns a count of the number of data items for the key to which the cursor refers.

The DBcursor->c_count method returns a non-zero error value on failure and 0 on success.

Parameters

countp
The countp parameter references memory into which the count of the number of duplicate data items is copied.
flags
The flags parameter is currently unused, and must be set to 0.

Errors

The DBcursor->c_count method may fail and return one of the following non-zero errors:

DB_REP_HANDLE_DEAD
The database handle has been invalidated because a replication election unrolled a committed transaction.
DB_REP_LOCKOUT
The operation was blocked by client/master synchronization.
EINVAL
If the cursor has not been initialized; or if an invalid flag value or parameter was specified.

Class

DBC

See Also

Database Cursors and Related Methods

APIRef

Copyright (c) 1996-2005 Sleepycat Software, Inc. - All rights reserved.