Struct ExtractWarning 

pub struct ExtractWarning {
    pub description: String,
    pub page: Option<usize>,
    pub element: Option<String>,
    pub operator_index: Option<usize>,
    pub font_name: Option<String>,
}

A non-fatal warning encountered during extraction.

Warnings allow best-effort continuation when issues are encountered (e.g., missing font metrics, unknown operators). They include a description and optional source location context such as page number, operator index, and font name.

Fields

description: String

Human-readable description of the warning.

page: Option<usize>

Page number where the warning occurred (0-indexed), if applicable.

element: Option<String>

Element context (e.g., “char at offset 42”).

operator_index: Option<usize>

Index of the operator in the content stream where the warning occurred.

font_name: Option<String>

Font name associated with the warning, if applicable.

Implementations

impl ExtractWarning

pub fn new(description: impl Into<String>) -> Self

Create a warning with just a description.

pub fn on_page(description: impl Into<String>, page: usize) -> Self

Create a warning with page context.

pub fn with_context( description: impl Into<String>, page: usize, element: impl Into<String>, ) -> Self

Create a warning with full source context.

pub fn with_operator_context( description: impl Into<String>, operator_index: usize, font_name: impl Into<String>, ) -> Self

Create a warning with operator and font context.

Includes the operator index in the content stream and the font name, useful for diagnosing font-related issues during text extraction.

Trait Implementations

impl Clone for ExtractWarning

fn clone(&self) -> ExtractWarning

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ExtractWarning

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

Formats the value using the given formatter.

impl Display for ExtractWarning

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

Formats the value using the given formatter.

impl PartialEq for ExtractWarning

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for ExtractWarning