Enum ErfRewriteError 

pub enum ErfRewriteError {
    Io(Error),
    NoSuchEntry {
        index: usize,
        entry_count: usize,
    },
    DuplicateSubstitution {
        index: usize,
    },
    UnreadableEntry {
        index: usize,
        resref: ResRef,
        defect: EntryDefect,
    },
    OverlappingPayload {
        index: usize,
        offset: u64,
        earliest: u64,
    },
    KeyNamesMissingResourceRow {
        index: usize,
        row: usize,
    },
    RegionOutsidePrefix {
        region: &'static str,
        region_end: usize,
        prefix_end: usize,
    },
    TruncatedEntry {
        index: usize,
        expected: u64,
        copied: u64,
    },
    ValueOverflow(&'static str),
}

Errors produced while rewriting an ERF-family archive.

Variants

Io(Error)

I/O read/write failure.

NoSuchEntry

A substitution named an entry the archive does not have.

Fields

index: usize

Table position the caller supplied.

entry_count: usize

Number of entries in the archive.

DuplicateSubstitution

Two substitutions named the same entry.

Fields

index: usize

Table position named twice.

UnreadableEntry

An entry that was not being replaced cannot be read.

Substituting the entry is the way past this: supplying its bytes means the unreadable range is never touched, which is how a damaged archive gets repaired rather than refused.

Fields

index: usize

Table position of the entry.

resref: ResRef

Name the archive gives it.

defect: EntryDefect

Why its bytes are unreachable.

OverlappingPayload

Two entries claim overlapping byte ranges.

Fields

index: usize

Table position of the entry that starts too early.

offset: u64

Offset it declares.

earliest: u64

First offset that was still free.

KeyNamesMissingResourceRow

A key entry points at a resource row outside the resource table.

Fields

index: usize

Table position of the key entry.

row: usize

Row it names.

RegionOutsidePrefix

A table lies outside the span copied verbatim from the source.

The header, the localized string block and both tables are copied as one region ending at the resource table. A file that puts one of them somewhere else is one the engine’s own sequential reader mis-parses, so it is refused rather than silently truncated.

Fields

region: &'static str

Which region is misplaced.

region_end: usize

Where it ends.

prefix_end: usize

Where the copied region ends.

TruncatedEntry

An entry’s bytes ran out before its declared size.

Fields

index: usize

Table position of the entry.

expected: u64

Size the table declares.

copied: u64

Bytes actually copied.

ValueOverflow(&'static str)

Value cannot fit the on-disk integer width.

Trait Implementations

impl Debug for ErfRewriteError

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

Formats the value using the given formatter.

impl Display for ErfRewriteError

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

Formats the value using the given formatter.

impl Error for ErfRewriteError

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 ErfRewriteError

fn from(source: Error) -> Self

Converts to this type from the input type.