Enum DfaWireError 

#[non_exhaustive]
pub enum DfaWireError {
    Truncated {
        needed: usize,
        got: usize,
    },
    BadMagic,
    VersionMismatch {
        expected: u32,
        found: u32,
    },
    ShapeMismatch {
        reason: &'static str,
    },
    SectionTooLarge {
        len: usize,
        max: usize,
    },
    Envelope(String),
}

Returned from CompiledDfa::from_bytes when the on-wire payload cannot be decoded into a valid DFA. The variant carries enough context for the caller to discriminate “stale cache, recompile” from “actual bug, refuse”.

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.

Truncated

Payload is shorter than the fixed header / a declared section.

Fields

needed: usize

Total bytes the decoder needed to read this section.

got: usize

Bytes actually provided in the input slice.

BadMagic

First four bytes were not the VDFA magic - caller likely passed an unrelated blob.

VersionMismatch

Wire version did not match the build’s DFA_WIRE_VERSION. The caller’s cache is from an older scanner consumer/vyre and must be rebuilt.

Fields

expected: u32

Wire version this build of vyre-primitives understands.

found: u32

Wire version recorded in the blob’s header.

ShapeMismatch

One of the array length fields disagreed with the declared state_count - corrupt or hand-crafted blob.

Fields

reason: &'static str

Static description of which length cross-check failed.

SectionTooLarge

A payload section exceeded the wire envelope’s u32 length prefix.

Fields

len: usize

Word count the caller attempted to encode.

max: usize

Maximum word count representable by the wire format.

Envelope(String)

The shared wire envelope returned an error variant this crate reports through the generic envelope branch.

Trait Implementations

impl Clone for DfaWireError

fn clone(&self) -> DfaWireError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DfaWireError

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

Formats the value using the given formatter.

impl Display for DfaWireError

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

Formats the value using the given formatter.

impl Error for DfaWireError

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.