Enum IrError 

#[non_exhaustive]
pub enum IrError {
    InlineCycle {
        op_id: String,
    },
    InlineUnknownOp {
        op_id: String,
    },
    InlineNonInlinable {
        op_id: String,
    },
    InlineArgCountMismatch {
        op_id: String,
        expected: usize,
        got: usize,
    },
    InlineNoOutput {
        op_id: String,
    },
    InlineOutputCountMismatch {
        op_id: String,
        got: usize,
    },
    Validation {
        issues: Vec<ValidationError>,
    },
    WireFormatValidation {
        message: String,
    },
    Lowering {
        message: String,
    },
    VersionMismatch {
        expected: u32,
        found: u32,
    },
    UnknownDialect {
        name: String,
        requested: String,
    },
    UnknownOp {
        dialect: String,
        op: String,
    },
}

Failure produced by foundation-owned IR transformation or Program wire boundaries.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

InlineCycle

A recursive composition cycle was found during operation inlining.

Fields

op_id: String

The operation identifier that closed the cycle.

InlineUnknownOp

Operation inlining could not resolve an operation id.

Fields

op_id: String

The missing operation identifier.

InlineNonInlinable

Operation inlining rejected an operation that must dispatch separately.

Fields

op_id: String

The operation identifier that cannot be inlined.

InlineArgCountMismatch

The number of arguments passed to an inlined operation did not match.

Fields

op_id: String

The operation identifier being expanded.

expected: usize

The number of arguments the callee expects.

got: usize

The number of arguments the caller provided.

InlineNoOutput

The inlined operation never wrote to its declared output buffer.

Fields

op_id: String

The operation identifier being expanded.

InlineOutputCountMismatch

The inlined operation declared an invalid number of output buffers.

Fields

op_id: String

The operation identifier being expanded.

got: usize

The actual number of buffers marked as outputs.

Validation

Structural validation rejected the Program with typed issues.

Fields

issues: Vec<ValidationError>

Foundation-owned validation issues in deterministic emission order.

WireFormatValidation

Wire-format payload failed validation checks.

Fields

message: String

Human-readable description of the validation failure.

Lowering

target-text lowering failed before a shader could be emitted.

Fields

message: String

Human-readable description of the lowering failure.

VersionMismatch

Wire-format schema version mismatch.

Fields

expected: u32

The schema version this runtime understands.

found: u32

The schema version present on the wire.

UnknownDialect

Unknown dialect on the wire.

Fields

name: String

The dialect identifier on the wire (e.g. "workgroup").

requested: String

The version string the encoder recorded for the dialect.

UnknownOp

Unknown op inside a known dialect.

Fields

dialect: String

The dialect that should contain the op.

op: String

The op identifier that could not be resolved.

Implementations

impl IrError

pub fn lowering(message: impl Into<String>) -> Self

Build a target-text lowering error with actionable guidance.

Trait Implementations

impl Clone for IrError

fn clone(&self) -> IrError

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for IrError

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

Formats the value using the given formatter.

impl Display for IrError

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

Formats the value using the given formatter.

impl Eq for IrError

impl Error for IrError

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 PartialEq for IrError

fn eq(&self, other: &IrError) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for IrError