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
impl Debug for EngineError
Source§impl Display for EngineError
impl Display for EngineError
Source§impl Error for EngineError
impl Error for EngineError
Source§fn source(&self) -> Option<&(dyn Error + 'static)>
fn source(&self) -> Option<&(dyn Error + 'static)>
1.0.0 · Source§fn description(&self) -> &str
fn description(&self) -> &str
use the Display impl or to_string()