Enum Error

pub enum Error {
    KeyExist,
    NotFound,
    NoData,
    PageNotFound,
    Corrupted,
    Panic,
    VersionMismatch,
    Invalid,
    MapFull,
    DbsFull,
    ReadersFull,
    TxnFull,
    CursorFull,
    PageFull,
    UnableExtendMapSize,
    Incompatible,
    BadRslot,
    BadTxn,
    BadValSize,
    BadDbi,
    Problem,
    Busy,
    Multival,
    BadSignature,
    WannaRecovery,
    KeyMismatch,
    DecodeError,
    Access,
    TooLarge,
    DecodeErrorLenDiff,
    NestedTransactionsUnsupportedWithWriteMap,
    WriteTransactionUnsupportedInReadOnlyMode,
    ReadTransactionTimeout,
    Permission,
    Other(i32),
}

An MDBX error kind.

Variants

KeyExist

Key/data pair already exists.

NotFound

No matching key/data pair found.

NoData

The cursor is already at the end of data.

PageNotFound

Requested page not found.

Corrupted

Database is corrupted.

Panic

Fatal environment error.

VersionMismatch

DB version mismatch.

Invalid

File is not an MDBX file.

MapFull

Environment map size limit reached.

DbsFull

Too many DBI-handles (maxdbs reached).

ReadersFull

Too many readers (maxreaders reached).

TxnFull

Transaction has too many dirty pages (i.e., the transaction is too big).

CursorFull

Cursor stack limit reached.

PageFull

Page has no more space.

UnableExtendMapSize

The database engine was unable to extend mapping, e.g. the address space is unavailable or busy.

This can mean:

• The database size was extended by other processes beyond the environment map size, and the engine was unable to extend the mapping while starting a read transaction. The environment should be re-opened to continue.
• The engine was unable to extend the mapping during a write transaction or an explicit call to change the geometry of the environment.

Incompatible

Environment or database is not compatible with the requested operation or flags.

BadRslot

Invalid reuse of reader locktable slot.

BadTxn

Transaction is not valid for requested operation.

BadValSize

Invalid size or alignment of key or data for the target database.

BadDbi

The specified DBI-handle is invalid.

Problem

Unexpected internal error.

Busy

Another write transaction is running.

Multival

The specified key has more than one associated value.

BadSignature

Wrong signature of a runtime object(s).

WannaRecovery

Database should be recovered, but cannot be done automatically since it’s in read-only mode.

KeyMismatch

The given key value is mismatched to the current cursor position.

DecodeError

Decode error: An invalid parameter was specified.

Access

The environment opened in read-only.

TooLarge

Database is too large for the current system.

DecodeErrorLenDiff

Decode error length difference:

An invalid parameter was specified, or the environment has an active write transaction.

NestedTransactionsUnsupportedWithWriteMap

If the Environment was opened with EnvironmentKind::WriteMap flag, nested transactions are not supported.

WriteTransactionUnsupportedInReadOnlyMode

If the Environment was opened with in read-only mode Mode::ReadOnly, write transactions can’t be opened.

ReadTransactionTimeout

Read transaction has been timed out.

Permission

Permission defined

Other(i32)

Unknown error code.

Implementations

impl Error

pub const fn from_err_code(err_code: c_int) -> Self

Converts a raw error code to an Error.

pub const fn to_err_code(&self) -> i32

Converts an Error to the raw error code.

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Error

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for Error

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for Error

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access #99301)

Provides type-based access to context intended for error reports.

impl From<Error> for i32

fn from(value: Error) -> Self

Converts to this type from the input type.

impl PartialEq for Error

fn eq(&self, other: &Error) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for Error

impl Eq for Error

impl StructuralPartialEq for Error

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 8 bytes

Size for each variant:

• KeyExist: 0 bytes
• NotFound: 0 bytes
• NoData: 0 bytes
• PageNotFound: 0 bytes
• Corrupted: 0 bytes
• Panic: 0 bytes
• VersionMismatch: 0 bytes
• Invalid: 0 bytes
• MapFull: 0 bytes
• DbsFull: 0 bytes
• ReadersFull: 0 bytes
• TxnFull: 0 bytes
• CursorFull: 0 bytes
• PageFull: 0 bytes
• UnableExtendMapSize: 0 bytes
• Incompatible: 0 bytes
• BadRslot: 0 bytes
• BadTxn: 0 bytes
• BadValSize: 0 bytes
• BadDbi: 0 bytes
• Problem: 0 bytes
• Busy: 0 bytes
• Multival: 0 bytes
• BadSignature: 0 bytes
• WannaRecovery: 0 bytes
• KeyMismatch: 0 bytes
• DecodeError: 0 bytes
• Access: 0 bytes
• TooLarge: 0 bytes
• DecodeErrorLenDiff: 0 bytes
• NestedTransactionsUnsupportedWithWriteMap: 0 bytes
• WriteTransactionUnsupportedInReadOnlyMode: 0 bytes
• ReadTransactionTimeout: 0 bytes
• Permission: 0 bytes
• Other: 4 bytes