Enum KernelError 

pub enum KernelError {
    Source(String),
    Assembly(AssemblyError),
    Refused {
        engine: Engine,
        reason: String,
    },
    ConstantFold {
        reason: String,
    },
    Write(WriteError),
    ConstInit {
        name: String,
        reason: String,
    },
}

Why a kernel was not built: the one error type of every constructor that takes an Engine.

Variants

Source(String)

The source did not parse or compile; the message is the DSL front end’s.

Assembly(AssemblyError)

The graph did not assemble.

Refused

The engine refuses this graph, which the interpreter accepts; reason names the node or construct.

Fields

engine: Engine

The engine that refused.

reason: String

The node or construct it cannot run.

ConstantFold

A compile-constant step could not be computed. A step no input reaches runs once at build, so what it does there it will do on every pull; there is nothing a later evaluation could supply that would make it succeed. Distinct from Self::Refused, which is one engine declining a program the others accept: every engine reports this one, and reports it at build.

Fields

reason: String

The failure as the node reported it, enriched with the node’s name, the outputs it feeds, and the program’s diagnostic context, as an evaluation failure would be.

Write(WriteError)

A value written into a kernel while building it was refused: an iteration binding or a value a binder copied from a parent that does not satisfy the child’s declared input.

ConstInit

A const binding could not be computed when the kernel was initialized. A const is evaluated once, at initialization, so a failing const makes initialization fail.

Fields

name: String

The const.

reason: String

Why its expression failed, as the node reported it.

Trait Implementations

impl Debug for KernelError

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

Formats the value using the given formatter.

impl Display for KernelError

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

Formats the value using the given formatter.

impl Error for KernelError

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<AssemblyError> for KernelError

fn from(e: AssemblyError) -> Self

Converts to this type from the input type.