Enum ZiPatchError 

#[non_exhaustive]
pub enum ZiPatchError {
    Io(Error),
    InvalidMagic,
    UnknownChunkTag([u8; 4]),
    UnknownSqpkCommand(u8),
    ChecksumMismatch {
        tag: [u8; 4],
        expected: u32,
        actual: u32,
    },
    Decompress(Error),
    InvalidField {
        context: &'static str,
    },
    OversizedChunk(usize),
    UnknownFileOperation(u8),
    Utf8Error(FromUtf8Error),
    BinrwError(Error),
    NegativeFileOffset(i64),
    TruncatedPatch,
}

All failures returned by parsing or applying a ZiPatch stream.

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.

Io(Error)

Underlying I/O failure from the patch source or target filesystem.

InvalidMagic

The 12-byte ZiPatch magic header was missing or did not match.

UnknownChunkTag([u8; 4])

A 4-byte chunk tag was not recognised by the parser.

UnknownSqpkCommand(u8)

A SQPK sub-command byte was not recognised by the parser.

ChecksumMismatch

A chunk’s recorded CRC32 did not match the computed CRC32.

Fields

tag: [u8; 4]

Tag of the chunk whose checksum failed.

expected: u32

CRC32 stored in the patch file.

actual: u32

CRC32 computed over the actual chunk bytes.

Decompress(Error)

DEFLATE decompression of a SqpkFile block failed.

InvalidField

A field value failed a parser invariant (e.g. negative size).

Fields

context: &'static str

Human-readable description of which field was invalid.

OversizedChunk(usize)

A chunk declared a size larger than the parser’s maximum.

UnknownFileOperation(u8)

A SqpkFile operation byte was not recognised.

Utf8Error(FromUtf8Error)

A UTF-8 decode failed when reading a path or name field.

BinrwError(Error)

A binrw parser produced an error; wraps the underlying cause.

NegativeFileOffset(i64)

A SqpkFile carried a negative file_offset that cannot be applied.

TruncatedPatch

Stream ended without an EOF_ chunk; download or copy was truncated.

Trait Implementations

impl Debug for ZiPatchError

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

Formats the value using the given formatter.

impl Display for ZiPatchError

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

Formats the value using the given formatter.

impl Error for ZiPatchError

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 ZiPatchError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ZiPatchError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<FromUtf8Error> for ZiPatchError

fn from(source: FromUtf8Error) -> Self

Converts to this type from the input type.