import com.sleepycat.db.*;

public void key_range(DbTxn txnid
	Dbt key, DbKeyRange key_range, int flags)
	throws DbException;

Description

The Db.key_range method returns an estimate of the proportion of keys that are less than, equal to and greater than the specified key. The underlying database must be of type Btree.

The information is returned in the key_range argument, which contains three elements of type double, less, equal and greater. Values are in the range of 0 to 1, e.g., if the field less is 0.05, that indicates that 5% of the keys in the database are less than the key argument. The value for equal will be zero if there is no matching key and non-zero otherwise.

If the file is being accessed under transaction protection, the txnid parameter is a transaction ID returned from DbEnv.txn_begin, otherwise, NULL. The Db.key_range method does not retain the locks it acquires for the life of the transaction, so estimates may not be repeatable.

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

The Db.key_range method throws an exception that encapsulates a non-zero error value on failure.

Errors

The Db.key_range method may fail and throw an exception encapsulating a non-zero error for the following conditions:

EINVAL

An invalid flag value or parameter was specified.

The underlying database was not of type Btree.

If the operation was selected to resolve a deadlock, the Db.key_range method will fail and throw a DbDeadlockException exception.

The Db.key_range method may fail and throw an exception for errors specified for other Berkeley DB and C library or system methods. If a catastrophic error has occurred, the Db.key_range method may fail and throw a DbRunRecoveryException, in which case all subsequent Berkeley DB calls will fail in the same way.

Class

See Also