Enum DocError 

#[non_exhaustive]
pub enum DocError {
    Iff(IffError),
    Bzz(BzzError),
    Iw44(Iw44Error),
    Jb2(Jb2Error),
    NotDjVu([u8; 4]),
    MissingChunk(&'static str),
    Malformed(&'static str),
    IndirectResolve(String),
    ComponentResolve(ComponentResolveError),
    ComponentKindMismatch {
        component: ComponentId,
        found: [u8; 4],
        expected: ComponentKind,
    },
    PageOutOfRange {
        index: usize,
        count: usize,
    },
    InvalidUtf8,
    NoResolver,
    Io(Error),
    Smmr(String),
    Text(TextError),
    Annotation(AnnotationError),
    Metadata(MetadataError),
    ResourceLimit(ResourceLimitExceeded),
}

Errors that can occur when working with the DjVuDocument API.

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.

Iff(IffError)

IFF container parse error.

Bzz(BzzError)

BZZ decompression error.

Iw44(Iw44Error)

IW44 wavelet decoding error.

Jb2(Jb2Error)

JB2 bilevel image decoding error.

NotDjVu([u8; 4])

The file is not a supported DjVu format.

MissingChunk(&'static str)

A required chunk is missing.

Malformed(&'static str)

The document is malformed (description included).

IndirectResolve(String)

An indirect page reference could not be resolved.

ComponentResolve(ComponentResolveError)

A typed resolver could not provide one indirect component.

ComponentKindMismatch

A resolved component’s FORM type disagrees with its DIRM classification.

Fields

component: ComponentId

Identity from the DIRM entry.

found: [u8; 4]

FORM type found in the resolved bytes.

expected: ComponentKind

FORM type required by the DIRM kind.

PageOutOfRange

Page index is out of range.

Fields

index: usize

count: usize

InvalidUtf8

Invalid UTF-8 in a string field.

No longer produced since #524: NAVM bookmark strings are decoded leniently (CP1252 fallback). Kept so matching code keeps compiling.

NoResolver

The resolver callback is required for indirect documents but was not provided.

Io(Error)

I/O error when reading file data (only with std feature).

Smmr(String)

G4/MMR mask decoding error.

Text(TextError)

Text layer parse error.

Annotation(AnnotationError)

Annotation parse error.

Metadata(MetadataError)

Metadata parse error.

ResourceLimit(ResourceLimitExceeded)

A configured resource limit was exceeded during document parse/open.

Trait Implementations

impl Debug for DocError

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

Formats the value using the given formatter.

impl Display for DocError

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

Formats the value using the given formatter.

impl Error for DocError

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<AnnotationError> for DocError

fn from(source: AnnotationError) -> Self

Converts to this type from the input type.

impl From<BzzError> for DocError

fn from(source: BzzError) -> Self

Converts to this type from the input type.

impl From<ComponentResolveError> for DocError

fn from(source: ComponentResolveError) -> Self

Converts to this type from the input type.

impl From<DocError> for DjvmError

fn from(source: DocError) -> Self

Converts to this type from the input type.

impl From<DocError> for RenderError

fn from(source: DocError) -> Self

Converts to this type from the input type.

impl From<DocError> for PdfError

fn from(source: DocError) -> Self

Converts to this type from the input type.

impl From<DocError> for EpubError

fn from(source: DocError) -> Self

Converts to this type from the input type.

impl From<DocError> for CbzError

fn from(source: DocError) -> Self

Converts to this type from the input type.

impl From<DocError> for TiffError

fn from(source: DocError) -> Self

Converts to this type from the input type.

impl From<DocError> for AsyncLazyError

fn from(source: DocError) -> Self

Converts to this type from the input type.

impl From<DocError> for TextSerializeError

fn from(source: DocError) -> Self

Converts to this type from the input type.

impl From<Error> for DocError

fn from(source: Error) -> 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<Iw44Error> for DocError

fn from(source: Iw44Error) -> Self

Converts to this type from the input type.

impl From<Jb2Error> for DocError

fn from(source: Jb2Error) -> Self

Converts to this type from the input type.

impl From<MetadataError> for DocError

fn from(source: MetadataError) -> Self

Converts to this type from the input type.

impl From<ResourceLimitExceeded> for DocError

fn from(source: ResourceLimitExceeded) -> Self

Converts to this type from the input type.

impl From<TextError> for DocError

fn from(source: TextError) -> Self

Converts to this type from the input type.