Enum Error 

pub enum Error {
    BadMagic,
    UnsupportedVersion {
        found: u8,
        supported: u8,
    },
    MalformedHeader(&'static str),
    Truncated,
    OutOfBounds,
    IndexOutOfBounds,
    BadUtf8,
    BadSchema(String),
    TypeMismatch {
        expected: String,
        got: String,
    },
    Incompatible(String),
    UnknownFieldId(u16),
    DuplicateField(u16),
    DuplicateMapKey,
    BadUnionTag(u32),
    MissingField(u16),
    SchemaIdMismatch {
        message: u128,
        expected: u128,
    },
    NoInlineSchema,
    DepthLimitExceeded,
    TraversalBudgetExceeded,
    MessageTooLarge,
    BadContainer(&'static str),
    Internal(&'static str),
}

Variants

BadMagic

Message does not start with the “VRT” magic family at all — not a Veritate message.

UnsupportedVersion

A Veritate message (“VRT” prefix) whose version byte this decoder does not implement. found is the version digit in the magic; supported is what this build understands. Guarantees a vN message can never be silently misread as vM.

Fields

found: u8

supported: u8

MalformedHeader(&'static str)

The fixed header is structurally invalid for this version: an unknown flag bit, or a reserved field that is not zero.

Truncated

Buffer too short for the fixed header or a declared region.

OutOfBounds

An offset or length points outside the message buffer.

IndexOutOfBounds

List element index past the end of the list.

BadUtf8

A string field holds invalid UTF-8.

BadSchema(String)

The (inline) schema bytes are malformed or non-canonical.

TypeMismatch

A value’s type does not match the schema field type (write path), or a typed getter was used on a differently-typed field (read path).

Fields

expected: String

got: String

Incompatible(String)

Writer and reader schema cannot be resolved (e.g. int narrowing).

UnknownFieldId(u16)

A value referenced a field ID that is not in the schema.

DuplicateField(u16)

The same field ID appeared twice in one struct value.

DuplicateMapKey

The same key appeared twice in one map value.

BadUnionTag(u32)

A union value or wire tag selected a variant index that does not exist.

MissingField(u16)

A dense struct was encoded without one of its (mandatory) fields.

SchemaIdMismatch

The message’s schema id does not match the resolver’s writer schema (or the inline schema bytes hash to something else).

Fields

message: u128

expected: u128

NoInlineSchema

dump_json needs an inline schema but the message was hash-only.

DepthLimitExceeded

Recursion (nested structs/lists) exceeded the safety depth limit — the message may contain an offset cycle or hostile nesting.

TraversalBudgetExceeded

A bounded read exhausted its traversal budget: the message followed offsets that would touch more bytes than the budget allows (an amplification guard for untrusted input — see Budget / the wire spec §5.2).

MessageTooLarge

Message would exceed the 4 GiB u32-offset limit.

BadContainer(&'static str)

A .vertc container file is malformed: bad magic/version, an index pointing out of bounds, a misaligned or overlapping record, etc.

Internal(&'static str)

Internal invariant violation (a bug in this library).

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Eq for Error

impl Error for Error

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 Error

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Error