Enum Error 

pub enum Error {
    Io {
        message: String,
    },
    Invalid {
        message: String,
    },
    UnexpectedToken {
        expected: Vec<&'static str>,
        got: &'static str,
    },
    UnexpectedSymbol {
        expected: Vec<&'static str>,
        got: String,
    },
    ArgCountMismatch {
        expected: u64,
        got: u64,
    },
    Deserialize {
        path: String,
        expected: &'static str,
        got: String,
    },
}

Errors returned by [to_wxf][crate::to_wxf] / [from_wxf][crate::from_wxf] and every ToWXF / FromWXF impl.

Variants

Io

An underlying std::io::Error from a writer, flattened to its message.

Fields

message: String

Display text of the underlying I/O error.

Invalid

Malformed input with no further structured data worth surfacing: bad/short header, wrong version/separator, truncated or over-long varint, unexpected EOF, byte-count overflow, unknown token/element byte, invalid UTF-8, an empty enum, a NaN real, an unparseable symbol name, or an unsupported packed-array element type. The message says which.

Fields

message: String

Human-readable description of what was malformed.

UnexpectedToken

Got a token that isn’t one of the accepted set for this position. An empty expected means “any value token except the one we got” (e.g. a Rule where a value was required).

Fields

expected: Vec<&'static str>

Token names that would have been accepted.

got: &'static str

The token name actually read.

UnexpectedSymbol

Got a Symbol whose name isn’t one of the accepted set (e.g. True/False, or an Option/Result variant name).

Fields

expected: Vec<&'static str>

Symbol / variant names that would have been accepted.

got: String

The name actually read.

ArgCountMismatch

A Function’s argument count didn’t match what the caller expected.

Fields

expected: u64

Arguments the caller expected.

got: u64

Arguments actually present.

Deserialize

Type mismatch during typed deserialization via FromWXF. Threaded with a dotted field path by the derive (e.g. "Frame.payload").

Fields

path: String

Dotted field accessor, e.g. "Frame.payload".

expected: &'static str

Description of the expected wire shape.

got: String

Description of the actual wire shape encountered.

Implementations

impl Error

pub fn invalid(message: String) -> Self

Build an Error::Invalid from a message — for malformed input that has no further structured data worth a dedicated variant.

pub fn unexpected_token(expected: &[&'static str], got: ExpressionEnum) -> Self

Build an Error::UnexpectedToken from the accepted token names and the token actually read. An empty expected slice means “any token but this”.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl From<Error> for Error

fn from(e: Error) -> Self

Converts to this type from the input type.