#[non_exhaustive]pub enum EvalError {
NoRuntime {
lang: String,
},
UndeclaredInput {
fn_name: String,
},
Cycle {
cell_id: String,
},
DepthExceeded {
limit: usize,
},
BudgetExceeded {
fuel: u64,
},
NameUnresolved {
fn_name: String,
asof: String,
},
Store(StoreError),
Runtime(String),
Suspended,
InputNotCovered {
cell_id: String,
},
InvalidInput(Error),
Fault(Fault),
}Expand description
What evaluating a function can fail with: returned by Inputs::read
and Budget::charge, and by a Runtime.
A runtime propagates every error it gets from Inputs::read or Budget::charge
unchanged (with ?). The engine does not depend on it: it records each such error when it
happens, and what the runtime returns after it is ignored.
Variants (Non-exhaustive)§
This enum is marked as non-exhaustive
NoRuntime
No runtime is configured for the function’s code.lang.
UndeclaredInput
The function read a function its descriptor does not declare in inputs.
Cycle
The cell reappeared on the evaluation stack: it depends on itself.
DepthExceeded
The evaluation stack reached the engine’s depth limit.
BudgetExceeded
The request’s fuel (runtime steps plus input reads) ran out.
NameUnresolved
A function name has no binding as of the evaluation’s asof.
Store(StoreError)
The store failed.
Runtime(String)
The runtime failed: its own message.
Suspended
The input read is not available yet: the engine evaluates it, then runs the reading
function again from the start (see Inputs). Added to the brief’s
list: it is how evaluation suspends without native recursion.
InputNotCovered
The input has no value as of the evaluation’s asof (a stored cell with no version
answering then, or a computed cell one of whose inputs has none). The reading cell has
no value either (Answer::NotCovered), even if the
runtime catches it: a receipt lists the inputs read, and cannot list an absence, so a
value computed from one could be neither checked against its inputs nor recomputed.
Added to the brief’s list.
InvalidInput(Error)
The arguments given to Inputs::read do not make a cell of the input function (a
slice, an unknown or missing argument, a type that differs from the signature). Added to
the brief’s list: it is the runtime’s mistake, not the engine’s or the store’s.
Fault(Fault)
A formula evaluation fault (SPEC 15.11, 15.12): the cell has no value, deterministically
(E_FORMULA_DIV_ZERO, E_FORMULA_DOMAIN, E_FORMULA_RANGE, E_FORMULA_EMPTY,
E_FORMULA_ABSENT, E_FORMULA_FUTURE). Returned by a runtime, it makes the answer
Answer::NotCovered with the fault, and nothing is
stored for the cell. Returned by a read (an input that faulted, a computed slice with a
member without a value, a transaction time after the asof), the runtime may catch it
where its language allows. Since 0.3.0.
Trait Implementations§
Source§impl Error for EvalError
impl Error for EvalError
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()