Db::get_byteswapped()

#include <db_cxx.h>
 
int
Db::get_byteswapped(int *isswapped);

The Db::get_byteswapped() method returns whether the underlying database files were created on an architecture of the same byte order as the current one, or if they were not (that is, big-endian on a little-endian machine, or vice versa). This information may be used to determine whether application data needs to be adjusted for this architecture or not.

The Db::get_byteswapped() method may not be called before the Db::open() method is called.

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

isswapped

If the underlying database files were created on an architecture of the same byte order as the current one, 0 is stored into the memory location referenced by isswapped. If the underlying database files were created on an architecture of a different byte order as the current one, 1 is stored into the memory location referenced by isswapped.

Errors

The Db::get_byteswapped() 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 before Db::open() was called; or if an invalid flag value or parameter was specified.

Class

Db

See Also

Database and Related Methods