Enum MutError 

pub enum MutError {
    Parse(LegacyError),
    PathOutOfRange {
        index: usize,
        depth: usize,
        len: usize,
    },
    PathTraversesLeaf {
        depth: usize,
        len: usize,
    },
    NotALeaf,
    EmptyPath,
    PageOutOfRange {
        index: usize,
        count: usize,
    },
    MissingPageInfo,
    InfoParse(IffError),
    IndirectDjvmUnsupported,
    DirmMalformed(&'static str),
    DirmComponentCountMismatch {
        dirm: usize,
        children: usize,
    },
    BookmarksRequireDjvm,
}

Errors produced by DjVuDocumentMut operations.

Variants

Parse(LegacyError)

IFF parse error during DjVuDocumentMut::from_bytes.

PathOutOfRange

The path indexed past the end of a FORM’s children.

Fields

index: usize

depth: usize

len: usize

PathTraversesLeaf

The path traversed into a leaf chunk and tried to keep going.

Fields

depth: usize

len: usize

NotALeaf

replace_leaf was called with a path that ends on a FORM chunk rather than a leaf.

EmptyPath

The path is empty — must contain at least one index.

PageOutOfRange

page_mut was called with an index past the document’s page count.

Fields

index: usize

Requested page index.

count: usize

Number of pages in the document.

MissingPageInfo

The page has no INFO chunk, which is required to encode chunks whose payload depends on page height (currently set_text_layer).

InfoParse(IffError)

The page’s INFO chunk failed to parse.

IndirectDjvmUnsupported

The operation requires DIRM offset recomputation, which is not implemented for indirect (non-bundled) FORM:DJVM documents — those reference page bytes in external files via a resolver, so editing them in place would also need the external files rewritten. Tracked as a follow-up PR (PR5) in the #222 sequence.

DirmMalformed(&'static str)

The DIRM chunk was malformed in a way that prevents offset recomputation. Should not occur after a successful DjVuDocumentMut::from_bytes on a well-formed DJVM document.

DirmComponentCountMismatch

The number of FORM:DJVU/FORM:DJVI components in the bundle does not match the count recorded in DIRM. Indicates a structurally inconsistent document.

Fields

dirm: usize

Component count read from DIRM (nfiles).

children: usize

Actual count of FORM:DJVU/FORM:DJVI children in the root.

BookmarksRequireDjvm

set_bookmarks was called on a FORM:DJVU (single-page) document. NAVM bookmarks live in FORM:DJVM bundles only.

Trait Implementations

impl Debug for MutError

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

Formats the value using the given formatter.

impl Display for MutError

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

Formats the value using the given formatter.

impl Error for MutError

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 MutError

fn from(source: IffError) -> Self

Converts to this type from the input type.

impl From<LegacyError> for MutError

fn from(source: LegacyError) -> Self

Converts to this type from the input type.