Enum IffError 

#[non_exhaustive]
pub enum IffError {
    TooShort,
    BadMagic {
        got: [u8; 4],
    },
    UnknownFormType {
        id: [u8; 4],
    },
    ChunkTooLong {
        id: [u8; 4],
        claimed: u32,
        available: usize,
    },
    DepthLimitExceeded {
        max: usize,
    },
    Truncated,
    UnsupportedVersion {
        version: u16,
    },
}

Errors that can occur while parsing the IFF container.

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.

TooShort

Input data is too short to contain a valid IFF file.

BadMagic

The AT&T magic bytes were not found at the start of the file.

Fields

got: [u8; 4]

UnknownFormType

The FORM type identifier is not a recognised DjVu type.

Note: this is not an error — callers may encounter unknown form types in bundled documents and should handle them gracefully.

Fields

id: [u8; 4]

ChunkTooLong

A chunk header claims more bytes than are available in the buffer.

Fields

id: [u8; 4]

claimed: u32

available: usize

DepthLimitExceeded

A FORM nesting chain exceeded the structural inspection limit.

Fields

max: usize

Maximum permitted FORM nesting depth.

Truncated

The input ended unexpectedly in the middle of a chunk.

UnsupportedVersion

The INFO chunk declares a format version DjVuLibre itself refuses to decode. DjVuLibre’s DJVUVERSION_TOO_NEW forward-compatibility ceiling (libdjvu/DjVuInfo.h) is 50: if (info->version >= 50) throw "Cannot decode DjVu files with version>= 50". We match that ceiling rather than silently decoding files DjVuLibre itself refuses.

Fields

version: u16

Trait Implementations

impl Debug for IffError

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

Formats the value using the given formatter.

impl Display for IffError

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

Formats the value using the given formatter.

impl Eq for IffError

impl Error for IffError

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<IffError> for DjVuError

fn from(source: IffError) -> Self

Converts to this type from the input type.

impl From<IffError> for DjvmError

fn from(source: IffError) -> Self

Converts to this type from the input type.

impl From<IffError> for DocError

fn from(source: IffError) -> Self

Converts to this type from the input type.

impl From<IffError> for MutError

fn from(source: IffError) -> Self

Converts to this type from the input type.

impl From<IffError> for AsyncLazyError

fn from(source: IffError) -> Self

Converts to this type from the input type.

impl PartialEq for IffError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for IffError