Enum Error 

pub enum Error {
    InvalidHeader(String),
    UnsupportedVersion(String),
    ParseError {
        offset: usize,
        reason: String,
    },
    ParseWarning {
        offset: usize,
        message: String,
    },
    InvalidXref,
    ObjectNotFound(u32, u16),
    InvalidObjectType {
        expected: String,
        found: String,
    },
    UnexpectedEof,
    Io(Error),
    Utf8Error(Utf8Error),
    Unsupported(String),
    InvalidPdf(String),
    Decode(String),
    Encode(String),
    UnsupportedFilter(String),
    Font(String),
    Image(String),
    CircularReference(ObjectRef),
    RecursionLimitExceeded(u32),
    InvalidOperation(String),
    LayoutAnalysis(String),
    EncryptedPdf,
    Type4Runtime(String),
}

Error types that can occur during PDF processing.

Variants

InvalidHeader(String)

Invalid PDF header (expected ‘%PDF-’)

UnsupportedVersion(String)

Unsupported PDF version

ParseError

Parse error at specific byte offset

Fields

offset: usize

Byte offset where error occurred

reason: String

Reason for parse failure

ParseWarning

Parse warning (non-fatal)

Fields

offset: usize

Byte offset where warning occurred

message: String

Warning message

InvalidXref

Invalid cross-reference table

ObjectNotFound(u32, u16)

Referenced object not found in cross-reference table

InvalidObjectType

Object has wrong type

Fields

expected: String

Expected object type

found: String

Actual object type found

UnexpectedEof

Unexpected end of file

Io(Error)

IO error

Utf8Error(Utf8Error)

UTF-8 decoding error

Unsupported(String)

Unsupported feature

InvalidPdf(String)

Invalid PDF structure (generic)

Decode(String)

Stream decoding error

Encode(String)

Encoding error (e.g., image encoding)

UnsupportedFilter(String)

Unsupported stream filter

Font(String)

Font error

Image(String)

Image error

CircularReference(ObjectRef)

Circular reference detected in object graph

RecursionLimitExceeded(u32)

Recursion depth limit exceeded

InvalidOperation(String)

Invalid operation (e.g., calling methods on uninitialized document)

LayoutAnalysis(String)

Layout analysis error

EncryptedPdf

PDF is encrypted and has not been authenticated with the correct password.

This error is returned when attempting to extract content from a PDF that requires a password. Call authenticate(password) or open with PdfDocument::open_with_password() before extracting content.

Type4Runtime(String)

Runtime error during PostScript Type 4 function evaluation (stack underflow, typecheck, division by zero, overflow, undefined operations).

Distinct from Error::InvalidPdf, which means a malformed parse; Type4Runtime means a syntactically valid program failed at execution time. Callers should typically fall back to a default gray rendering rather than failing the entire page.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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 Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Utf8Error> for Error

fn from(source: Utf8Error) -> Self

Converts to this type from the input type.