Enum Error 

#[non_exhaustive]
pub enum Error {
    Format {
        message: String,
    },
    Locked,
    Busy {
        message: String,
    },
    Corrupt {
        message: String,
    },
    ReadOnly,
    Io {
        source: Error,
    },
    Version {
        found: u16,
        supported: u16,
    },
}

All failure modes surfaced by graph-r.

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.

Format

A file or byte stream failed structural validation.

Fields

message: String

What was malformed and where.

Locked

Another writer held this store’s commit lock for longer than the store’s Config::lock_wait (in this process or another).

Busy

A bounded wait for internal capacity expired (e.g. every generation slot is pinned by long-lived snapshots during compaction).

Fields

message: String

Which capacity was exhausted.

Corrupt

The on-disk state is inconsistent in a way replay cannot repair.

Fields

message: String

What invariant was violated.

ReadOnly

A mutating operation was attempted on a read-only store handle.

Io

An underlying I/O failure.

Fields

source: Error

The originating I/O error.

Version

A file written in a format version this build does not read (an older store to rebuild, or a newer one from a later release). Its own variant so a caller can tell “rebuild this” from “this is damaged” without reading the message.

Fields

found: u16

The version the file declares.

supported: u16

The one version this build reads and writes.

Implementations

impl Error

pub fn format(message: impl Into<String>) -> Self

A structural-validation failure.

pub fn busy(message: impl Into<String>) -> Self

A capacity-exhaustion refusal.

pub fn corrupt(message: impl Into<String>) -> Self

An unrepairable inconsistency.

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<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.