#[non_exhaustive]pub enum EvalError {
Show 13 variants
NoRuntime {
lang: String,
},
UndeclaredInput {
fn_name: String,
},
Cycle {
path: Vec<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),
BlobUnavailable {
sha256: String,
reason: String,
},
}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. The path holds the canonical calls in read order, from the cell that reappeared to its second occurrence.
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.
A blob’s content could not be obtained (Inputs::read_blob):
the store has none for its SHA-256, or what it has is not the blob’s (another length or
hash). The evaluator’s failure, not a fault of the cell (SPEC 15.12,
E_FORMULA_BLOB_UNAVAILABLE): the request fails with
EngineError::BlobUnavailable whatever the runtime returns after it. Since 0.3.2.
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()