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

## Db::set_lorder()

    #include <db_cxx.h>

    int
    Db::set_lorder(int lorder);

Set the byte order for integers in the stored database metadata. The host byte order of the machine where the Berkeley DB library was compiled will be used if no byte order is set.

The access methods provide no guarantees about the byte ordering of the application data stored in the database, and applications are responsible for maintaining any necessary ordering.

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

The `Db::set_lorder()` 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_lorder()` will be ignored.

If creating additional databases in a single physical file, information specified to `Db::set_lorder()` will be ignored and the byte order of the existing databases will be used.

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

#### lorder

The lorder parameter should represent the byte order as an integer; for example, big endian order is the number 4,321, and little endian order is the number 1,234.

### Errors

The `Db::set_lorder()` 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_h_nelem() | Home | Db::set_message_stream()