Skip to main content

EngineError

Enum EngineError 

Source
pub enum EngineError {
    Formula(FormulaError),
    Graph(GraphError),
    Xlsx(XlsxError),
    CircularReference(Vec<CellId>),
    DuplicateSheet(String),
    StubSpaceExhausted,
}
Expand description

Everything that can fail while driving the calculation engine.

Parsing, dependency extraction, and XLSX coding delegate to their crates’ own errors. The engine adds exactly two of its own: a rejected workbook (duplicate sheet names on load) and the circular-reference report.

Variants§

§

Formula(FormulaError)

The formula text did not tokenize or parse (=SUM(, =Nope(1), =A1048577).

§

Graph(GraphError)

The formula’s references could not be modeled as dependency edges — most commonly sheet_core::GraphError::RangeTooLarge for a range wider than sheet_core::refs::RANGE_CELL_CAP cells.

§

Xlsx(XlsxError)

The XLSX codec failed to read or write a workbook.

§

CircularReference(Vec<CellId>)

The workbook contains circular references. The payload lists every cell that sits on a cycle (members of multi-cell cycles, plus self-references), sorted for determinism. Everything not on a cycle was still evaluated before this error was raised — Excel semantics: the rest of the workbook computes.

§

DuplicateSheet(String)

from_xlsx met two <sheet> elements with the same name. The engine keys sheets by name; it refuses to silently merge them.

§

StubSpaceExhausted

The formula references the very last grid cell and a sheet-qualified reference: no stub coordinate space remains above its local references for the cross-sheet rewrite. Rare to the point of pathology — XFD1048576 plus a cross-sheet read.

Trait Implementations§

Source§

impl Debug for EngineError

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Display for EngineError

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Error for EngineError

Source§

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any. Read more
1.0.0 · Source§

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

1.0.0 · Source§

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

Source§

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. Read more
Source§

impl From<FormulaError> for EngineError

Source§

fn from(e: FormulaError) -> Self

Converts to this type from the input type.
Source§

impl From<GraphError> for EngineError

Source§

fn from(e: GraphError) -> Self

Converts to this type from the input type.
Source§

impl From<XlsxError> for EngineError

Source§

fn from(e: XlsxError) -> Self

Converts to this type from the input type.

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToString for T
where T: Display + ?Sized,

Source§

fn to_string(&self) -> String

Converts the given value to a String. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.