Enum BufferError 

pub enum BufferError {
    UnknownField {
        name: String,
    },
    TypeMismatch {
        name: String,
        declared: &'static str,
        requested: &'static str,
    },
    BufferTooSmall {
        have: usize,
        need: usize,
    },
    ValueTooLarge {
        name: String,
        len: usize,
    },
    MalformedPayload {
        name: String,
        reason: &'static str,
    },
}

Failure modes when writing / reading typed fields against a buffer.

Variants

UnknownField

The requested field name does not appear in the offset table. Indicates a schema-drift bug or a typo at the call site.

Fields

name: String

Field name passed to the writer / reader.

TypeMismatch

The requested write / read type does not match the field’s declared type. Writing an i64 to a Bool slot would corrupt the layout for adjacent fields, so this surfaces as a hard error rather than a silent reinterpret.

Fields

name: String

Field name being accessed.

declared: &'static str

Type the schema declared for this field.

requested: &'static str

Type the caller’s writer / reader assumed.

BufferTooSmall

The buffer is shorter than the offset table’s root_size. Always indicates the buffer was truncated mid-flight (e.g. an out_buf the wasm module didn’t fully fill).

Fields

have: usize

Actual byte length of the buffer.

need: usize

Required length per the offset table.

ValueTooLarge

A pointer-indirect payload (String / List<Int>) is larger than the u32 length prefix can describe. Phase 2.c caps each payload at u32::MAX bytes / elements; longer values surface here rather than overflow silently.

Fields

name: String

Field name carrying the oversized payload.

len: usize

Requested length (bytes for String, elements for List<Int>).

MalformedPayload

A pointer-indirect read tripped over a malformed tail-area payload — the length prefix points beyond the buffer end, the pointer is null when the schema expects a value, or the utf-8 bytes inside a String payload are invalid.

Fields

name: String

Field name being read.

reason: &'static str

Why the payload couldn’t be decoded.

Trait Implementations

impl Clone for BufferError

fn clone(&self) -> BufferError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BufferError

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

Formats the value using the given formatter.

impl Display for BufferError

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

Formats the value using the given formatter.

impl Eq for BufferError

impl Error for BufferError

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 BufferError

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for BufferError