Enum Error 

pub enum Error {
    Io {
        source: Error,
    },
    TooManyElements,
    ElementTooBig,
    CorruptedFile {
        msg: String,
    },
    MagicMismatch {
        expected: u32,
        found: u32,
    },
    ChecksumMismatch {
        expected: u32,
        found: u32,
    },
    InvalidValue {
        msg: String,
    },
    OutOfBounds {
        msg: String,
    },
    SequenceMismatch {
        expected: u64,
        found: u64,
    },
    UnsupportedVersion {
        detected: u32,
        supported: u32,
    },
}

The error type for [QueueFile] operations.

Each variant represents a distinct category of failure that can occur when working with queue files.

Variants

Io

An I/O error occurred while reading or writing the queue file.

Fields

source: Error

TooManyElements

The queue contains more than i32::MAX elements.

This is a limitation of the on-disk format.

ElementTooBig

An individual element exceeds the maximum allowed size.

Elements are limited to i32::MAX bytes.

CorruptedFile

The queue file contains corrupted data.

This can indicate a hardware failure, incomplete write, or manual tampering with the file.

Fields

msg: String

MagicMismatch

The file header magic bytes don’t match the expected format.

Fields

expected: u32

found: u32

ChecksumMismatch

A CRC-32 checksum verification failed.

This indicates data corruption in the element header or payload.

Fields

expected: u32

found: u32

InvalidValue

A value in the queue file is invalid or out of expected range.

Fields

msg: String

OutOfBounds

A calculated position is outside the valid file bounds.

Fields

msg: String

SequenceMismatch

Element sequence numbers are not in the expected order.

This indicates a corrupted queue or recovery failure in v2 format.

Fields

expected: u64

found: u64

UnsupportedVersion

The queue file format version is not supported.

Fields

detected: u32

supported: u32

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, __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)

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.