Enum ArchiveError 

#[non_exhaustive]
pub enum ArchiveError {
    Decode {
        format: &'static str,
        detail: String,
    },
    TooLarge {
        cap: u64,
    },
    Open {
        format: &'static str,
        detail: String,
    },
    Read {
        format: &'static str,
        detail: String,
    },
    IndexOutOfRange {
        index: usize,
        count: usize,
    },
    DepthExceeded {
        max: usize,
        chain: String,
    },
    TooManyEntries {
        max: usize,
    },
    TotalInflatedExceeded {
        cap: u64,
    },
}

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.

Decode

A codec decoder failed on the packed stream.

Fields

format: &'static str

detail: String

TooLarge

The decompressed output exceeded the in-memory cap (bomb guard) — a loud failure, never a silent truncation.

Fields

cap: u64

Open

Parsing an archive’s directory / central structure failed.

Fields

format: &'static str

detail: String

Read

Extracting a single member failed (bad offset, unsupported member codec, CRC mismatch, …). The detail carries the backend’s own diagnostic.

Fields

format: &'static str

detail: String

IndexOutOfRange

A member index was out of range for the archive.

Fields

index: usize

count: usize

DepthExceeded

The recursion peeled past the configured nesting limit (bomb guard). The chain names the layer path that tripped it.

Fields

max: usize

chain: String

TooManyEntries

The cumulative number of members across the whole recursion exceeded the configured cap (bomb guard).

Fields

max: usize

TotalInflatedExceeded

The cumulative inflated size across the whole recursion exceeded the cap (bomb guard) — tracked across layers, not per layer.

Fields

cap: u64

Trait Implementations

impl Debug for ArchiveError

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

Formats the value using the given formatter.

impl Display for ArchiveError

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

Formats the value using the given formatter.

impl Error for ArchiveError

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.