Db::set_bt_minkey()
Prev | Chapter 2. The Db Handle | Next

## Db::set_bt_minkey()

    #include <db_cxx.h>

    int
    Db::set_bt_minkey(u_int32_t bt_minkey);

Set the minimum number of key/data pairs intended to be stored on any single Btree leaf page.

This value is used to determine if key or data items will be stored on overflow pages instead of Btree leaf pages. For more information on the specific algorithm used, see Minimum keys per page. The bt_minkey value specified must be at least 2; if bt_minkey is not explicitly set, a value of 2 is used.

The `Db::set_bt_minkey()` method configures a database, not only operations performed using the specified Db handle.

The `Db::set_bt_minkey()` method may not be called after the Db::open() method is called. If the database already exists when Db::open() is called, the information specified to `Db::set_bt_minkey()` will be ignored.

The `Db::set_bt_minkey()` 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.

### Parameters

#### bt_minkey

The bt_minkey parameter is the minimum number of key/data pairs intended to be stored on any single Btree leaf page.

### Errors

The `Db::set_bt_minkey()` method may fail and throw a DbException exception, encapsulating one of the following non-zero errors, or return one of the following non-zero errors:

#### EINVAL

If the method was called after Db::open() was called; or if an invalid flag value or parameter was specified.

### Class

Db

### See Also

Database and Related Methods

Prev | Up | Next
Db::set_bt_compress() | Home | Db::set_bt_prefix()