Enum Error

#[non_exhaustive]
pub enum Error {
    DatabaseAlreadyOpen,
    InvalidSavepoint,
    RepairAborted,
    PersistentSavepointExists,
    EphemeralSavepointExists,
    TransactionInProgress,
    Corrupted(String),
    UpgradeRequired(u8),
    ValueTooLarge(usize),
    TableTypeMismatch {
        table: String,
        key: TypeName,
        value: TypeName,
    },
    TableIsMultimap(String),
    TableIsNotMultimap(String),
    TypeDefinitionChanged {
        name: TypeName,
        alignment: usize,
        width: Option<usize>,
    },
    TableDoesNotExist(String),
    TableAlreadyOpen(String, &'static Location<'static>),
    Io(Error),
    PreviousIo,
    LockPoisoned(&'static Location<'static>),
    ReadTransactionStillInUse(ReadTransaction),
}

Superset of all other errors that can occur. Convenience enum so that users can convert all errors into a single type

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

DatabaseAlreadyOpen

The Database is already open. Cannot acquire lock.

InvalidSavepoint

This savepoint is invalid or cannot be created.

Savepoints become invalid when an older savepoint is restored after it was created, and savepoints cannot be created if the transaction is “dirty” (any tables have been opened)

RepairAborted

crate::RepairSession::abort was called.

PersistentSavepointExists

A persistent savepoint exists

EphemeralSavepointExists

An Ephemeral savepoint exists

TransactionInProgress

A transaction is still in-progress

Corrupted(String)

The Database is corrupted

UpgradeRequired(u8)

The database file is in an old file format and must be manually upgraded

ValueTooLarge(usize)

The value being inserted exceeds the maximum of 3GiB

TableTypeMismatch

Table types didn’t match.

Fields

table: String

key: TypeName

value: TypeName

TableIsMultimap(String)

The table is a multimap table

TableIsNotMultimap(String)

The table is not a multimap table

TypeDefinitionChanged

Fields

name: TypeName

alignment: usize

width: Option<usize>

TableDoesNotExist(String)

Table name does not match any table in database

TableAlreadyOpen(String, &'static Location<'static>)

Io(Error)

PreviousIo

A previous IO error occurred. The database must be closed and re-opened

LockPoisoned(&'static Location<'static>)

ReadTransactionStillInUse(ReadTransaction)

The transaction is still referenced by a table or other object

Trait Implementations

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, f: &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)

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

impl From<CommitError> for Error

fn from(err: CommitError) -> Error

Converts to this type from the input type.

impl From<CompactionError> for Error

fn from(err: CompactionError) -> Error

Converts to this type from the input type.

impl From<DatabaseError> for Error

fn from(err: DatabaseError) -> Error

Converts to this type from the input type.

impl From<Error> for Error

fn from(err: Error) -> Error

Converts to this type from the input type.

impl<T> From<PoisonError<T>> for Error

fn from(_: PoisonError<T>) -> Error

Converts to this type from the input type.

impl From<SavepointError> for Error

fn from(err: SavepointError) -> Error

Converts to this type from the input type.

impl From<StorageError> for Error

fn from(err: StorageError) -> Error

Converts to this type from the input type.

impl From<TableError> for Error

fn from(err: TableError) -> Error

Converts to this type from the input type.

impl From<TransactionError> for Error

fn from(err: TransactionError) -> Error

Converts to this type from the input type.

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: 144 bytes

Size for each variant:

• DatabaseAlreadyOpen: 0 bytes
• InvalidSavepoint: 0 bytes
• RepairAborted: 0 bytes
• PersistentSavepointExists: 0 bytes
• EphemeralSavepointExists: 0 bytes
• TransactionInProgress: 0 bytes
• Corrupted: 40 bytes
• UpgradeRequired: 17 bytes
• ValueTooLarge: 24 bytes
• TableTypeMismatch: 104 bytes
• TableIsMultimap: 40 bytes
• TableIsNotMultimap: 40 bytes
• TypeDefinitionChanged: 72 bytes
• TableDoesNotExist: 40 bytes
• TableAlreadyOpen: 48 bytes
• Io: 24 bytes
• PreviousIo: 0 bytes
• LockPoisoned: 24 bytes
• ReadTransactionStillInUse: 144 bytes