pdfium 0.10.3

Modern Rust interface to PDFium, the PDF library from Google
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105

// PDFium-rs -- Modern Rust interface to PDFium, the PDF library from Google
//
// Copyright (c) 2025-2026 Martin van der Werff <github (at) newinnovations.nl>
//
// This file is part of PDFium-rs.
//
// PDFium-rs is free software: you can redistribute it and/or modify it under the terms of
// the GNU General Public License as published by the Free Software Foundation, either version 3
// of the License, or (at your option) any later version.
//
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR
// IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
// FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
// DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
// BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
// STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

use std::{
    error::Error,
    ffi::NulError,
    fmt::{Display, Formatter},
};

/// Alias for `Result<T, PdfiumError>`
pub type PdfiumResult<T> = Result<T, PdfiumError>;

/// Enumerations of errors that can occur in PDFium and PDFium-rs
#[derive(Debug)]
pub enum PdfiumError {
    /// An unknown or unspecified error occurred
    Unknown,

    /// Failed to open, read, or access the PDF file
    FileError,

    /// The PDF file format is invalid or corrupted
    FormatError,

    /// The PDF requires a password that was not provided or is incorrect
    PasswordError,

    /// Security restrictions prevent the requested operation
    SecurityError,

    /// Error related to page operations (invalid page number, page not found, etc.)
    PageError,

    /// Error in color space or color profile processing
    ColorError,

    /// Input/output error with additional details
    IoError(String),

    /// A handle or pointer is null when it should be valid
    NullHandle,

    /// The requested image format is not supported for export/conversion
    UnsupportedImageFormat,

    /// The requested resource, object, or element was not found
    NotFound,

    /// A call to the PDFium library returned an error condition
    InvokationFailed,

    /// Error loading or initializing the PDFium library
    LibraryError(String),

    /// An error occurred in the image create
    ImageError,

    /// An error indicating that an interior nul byte was found in a string.
    NulError,

    /// An invalid or unclear render configuration was provided
    InvalidConfiguration(String),

    /// A circular reference was detected
    CircularReferenceError,

    /// An invalid enum value was provided
    InvalidEnumValue,
}

impl From<std::io::Error> for PdfiumError {
    fn from(err: std::io::Error) -> Self {
        PdfiumError::IoError(err.to_string())
    }
}

impl From<NulError> for PdfiumError {
    fn from(_err: NulError) -> Self {
        PdfiumError::NulError
    }
}

impl Error for PdfiumError {}

impl Display for PdfiumError {
    fn fmt(&self, f: &mut Formatter<'_>) -> std::fmt::Result {
        write!(f, "{self:#?}")
    }
}