Enum ErrorCode 

#[non_exhaustive]
pub enum ErrorCode {
    ZipInvalid,
    ZipEncrypted,
    PathInvalid,
    PathEmpty,
    PathLeadingSlash,
    PathTraversal,
    PathReservedChar,
    PathControlChar,
    DuplicatePath,
    PathConflict,
    ManifestInvalid,
    EntryPointInvalid,
    EntryPointMissing,
    EntryPointUnresolved,
    VersionUnsupported,
    ModeUnsupported,
    LimitExceeded,
    EntryPointChanged,
    NotFound,
    TextInvalid,
    Io,
}

A stable, machine-readable error code, such as ERR_ENTRYPOINT_MISSING.

Compare codes, not messages: messages can change between releases, codes don’t. ErrorCode::as_str gives the code as the spec writes it.

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.

ZipInvalid

Not a valid ZIP archive, or an entry is corrupt or uses an unsupported compression method (Section 4).

ZipEncrypted

An entry is encrypted (Section 4).

PathInvalid

An entry path breaks a rule in Section 5.4 not covered by a more specific code below (for example an empty or . segment).

PathEmpty

An entry path is empty.

PathLeadingSlash

An entry path starts with /.

PathTraversal

An entry path has a .. segment.

PathReservedChar

An entry path has a reserved character: \ : * ? " < > |.

PathControlChar

An entry path has a control character (U+0000–U+001F, U+007F).

DuplicatePath

Two entries have the same path after NFC normalization.

PathConflict

A file’s path is also the directory of another entry, such as docs and docs/intro.md.

ManifestInvalid

manifest.json is unreadable, or a critical field has the wrong type or value (Section 6.4).

EntryPointInvalid

The manifest entryPoint isn’t a valid entry point path (Section 5.5).

EntryPointMissing

The manifest entryPoint is valid but matches no entry (Section 5.5).

EntryPointUnresolved

No unambiguous entry point could be found (Section 5.5, rule 4).

VersionUnsupported

The archive targets a newer major version of the spec (Section 11).

ModeUnsupported

The manifest mode isn’t document or project (Section 5.7.5).

LimitExceeded

A resource limit (entry count, size, compression ratio) was exceeded (Section 13.1).

EntryPointChanged

Library-specific: an update would change or break which file the entry point resolves to (Section 14.1).

NotFound

Library-specific: a requested entry isn’t in the archive.

TextInvalid

Library-specific: an entry read as text isn’t valid UTF-8 (Section 7.1).

Io

Library-specific: reading or writing a file on disk failed.

Implementations

impl ErrorCode

pub const fn as_str(self) -> &'static str

The code as the spec writes it, for example "ERR_ZIP_INVALID".

Trait Implementations

impl Clone for ErrorCode

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for ErrorCode

impl Debug for ErrorCode

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

Formats the value using the given formatter.

impl Display for ErrorCode

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

Formats the value using the given formatter.

impl Eq for ErrorCode

impl Hash for ErrorCode

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ErrorCode

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for ErrorCode