Enum Error 

pub enum Error {
    Io(Error),
    Opc(Error),
    UnrecognizedFormat,
    FormatNotEnabled(&'static str),
    Word(Error),
    Excel(Error),
    Powerpoint(Error),
}

Errors from office-toolkit’s own file-level convenience layer.

Variants

Io(Error)

An I/O error occurred opening/reading/writing the file itself.

Opc(Error)

An error occurred at the OPC package level while inspecting a file to detect its format (crate::open) — before it’s even clear which format-specific reader should take over.

UnrecognizedFormat

The file is a well-formed OPC/ZIP package, but carries none of the three main parts (word/document.xml/xl/workbook.xml/ ppt/presentation.xml) crate::open knows how to recognize — either a format outside this crate’s scope, or a corrupt/foreign package. Detection never looks at the file’s name/extension, only at the package’s own parts, so this is never a false negative caused by a missing/wrong extension.

FormatNotEnabled(&'static str)

crate::open recognized the file’s format from its parts, but the matching Cargo feature (word/excel/powerpoint) isn’t enabled in this build, so no reader is available for it. Distinct from Error::UnrecognizedFormat — the file is a perfectly valid Office document, this build just wasn’t compiled to handle it.

Word(Error)

A .docx was recognized (or explicitly requested via crate::OpenFile/crate::SaveToFile), but word-ooxml itself failed to read or write it.

Excel(Error)

A .xlsx was recognized (or explicitly requested via crate::OpenFile/crate::SaveToFile), but excel-ooxml itself failed to read or write it.

Powerpoint(Error)

A .pptx was recognized (or explicitly requested via crate::OpenFile/crate::SaveToFile), but powerpoint-ooxml itself failed to read or write it.

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<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.