Enum ExtractError 

pub enum ExtractError {
    Pdf(Error),
    Io(Error),
    PageOutOfRange(u32, u32),
    UnsupportedFilter(String),
    ImageDecode(String),
    Other(String),
}

Errors returned by the pdf-extract crate while reading text or images from a PDF.

Customers usually see these wrapped inside pdfluent::Error after they bubble up through the facade. The inner variant tells the caller what kind of input prevented extraction.

Variants

Pdf(Error)

The underlying PDF byte stream could not be parsed.

Typically a malformed cross-reference table, a truncated stream, or an unsupported PDF construct. The wrapped lopdf::Error has the detail; surface it to the user when reporting the problem.

Io(Error)

An I/O error occurred while reading the document or writing extracted output (for image extraction targets).

PageOutOfRange(u32, u32)

The caller asked for a page index that does not exist in the document.

Fields: (requested_page, total_pages). Page numbers are 1-based at the public API; this variant carries the same convention.

UnsupportedFilter(String)

The image embedded on the page uses a PDF stream filter that this crate cannot decode (for example uncommon JPX profiles or unknown custom filters). The wrapped string identifies the filter by its PDF name.

ImageDecode(String)

Image bytes were extracted but could not be decoded by the image backend (corrupt JPEG/PNG/JPX payload, invalid colorspace, etc.).

Other(String)

A non-categorised extraction failure. Reserved for cases the more specific variants do not cover; the message describes the situation.

Trait Implementations

impl Debug for ExtractError

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

Formats the value using the given formatter.

impl Display for ExtractError

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

Formats the value using the given formatter.

impl Error for ExtractError

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 ExtractError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ExtractError

fn from(source: Error) -> Self

Converts to this type from the input type.