Enum Error 

pub enum Error {
    NotOle2,
    LegacyBiff,
    Cfb(Error),
    InvalidCfb(&'static str),
    MissingWorkbook,
    Biff(&'static str),
    Zip(&'static str),
    Xml(&'static str),
    Encrypted,
    EncryptedPackage,
    EncryptedOpenDocument,
    NoText,
    SheetOutOfRange,
}

Errors produced while opening or decoding a .xls workbook.

Variants

NotOle2

The input is not an OLE2 / CFB compound file (.xls is OLE2-based).

LegacyBiff

A raw pre-OLE2 Excel 2.0/3.0/4.0 stream (BIFF2–BIFF4) was detected. These predate the OLE2-wrapped [MS-XLS] format and are out of scope — only BIFF5/7 (Book) and BIFF8 (Workbook) workbooks are read.

Cfb(Error)

The OLE2 container could not be opened.

InvalidCfb(&'static str)

An OLE2-looking package is too corrupt or truncated to expose a bounded workbook stream through either the strict CFB reader or tolerant fallback.

MissingWorkbook

Neither the Workbook (BIFF8) nor Book (BIFF5/7) stream was found.

Biff(&'static str)

The BIFF record stream is malformed.

Zip(&'static str)

A ZIP-based spreadsheet container could not be opened as a ZIP package.

Xml(&'static str)

An OOXML part’s XML tree (xmltree::XmlTree) could not be parsed or edited: malformed markup (mismatched/unclosed tags, invalid UTF-8, a malformed entity reference, a misplaced XML declaration) or a budget was exceeded (nesting depth, node count, attributes per element). Edits are rejected rather than repaired, so a damaged part is never silently rewritten into different content.

Encrypted

The workbook uses an unsupported FILEPASS encryption mode/password. Extraction is refused rather than emitting ciphertext.

EncryptedPackage

The input is an OLE2-wrapped encrypted OOXML package (EncryptedPackage plus EncryptionInfo) rather than a readable BIFF workbook stream.

EncryptedOpenDocument

The input is an encrypted OpenDocument package. The manifest advertises encrypted payload streams, but rxls does not decrypt password-protected ODF.

NoText

The workbook parsed but contained no indexable text.

SheetOutOfRange

The requested worksheet index does not exist or is not a grid worksheet.

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.