Enum DecodeError 

pub enum DecodeError {
    UnexpectedEof {
        needed: usize,
        offset: usize,
    },
    InvalidUtf8 {
        offset: usize,
    },
    InvalidBool {
        value: u8,
        offset: usize,
    },
    InvalidChar {
        value: u32,
        offset: usize,
    },
    LengthExceeded {
        announced: usize,
        remaining: usize,
        offset: usize,
    },
    InvalidString {
        offset: usize,
        reason: &'static str,
    },
    InvalidEnum {
        kind: &'static str,
        value: u32,
    },
    UnknownMustUnderstandMember {
        member_id: u32,
    },
    MissingNonOptionalMember {
        member_id: u32,
    },
}

Error while decoding a value.

Variants

UnexpectedEof

Input ended before the expected end.

Fields

needed: usize

How many more bytes were expected.

offset: usize

Position in the stream where the EOF occurred.

InvalidUtf8

UTF-8 validation for a string value failed.

Fields

offset: usize

Position where the string began.

InvalidBool

Boolean byte was neither 0 nor 1 — forbidden by the XCDR spec.

Fields

value: u8

Byte actually read.

offset: usize

Position of the byte.

InvalidChar

Char value is not a valid Unicode codepoint.

Fields

value: u32

u32 value actually read.

offset: usize

Position.

LengthExceeded

Sequence/array length exceeds the bound or the remaining bytes.

Fields

announced: usize

How many elements the length announces.

remaining: usize

How many are actually still readable (best-effort).

offset: usize

Position.

InvalidString

String-format violation (e.g. missing null terminator, length 0).

Fields

offset: usize

Position where the string began.

reason: &'static str

Short description (static).

InvalidEnum

Unknown/invalid enum discriminator — used by policy decoders that operate in strict mode (e.g. QoS enums).

Fields

kind: &'static str

Enum name for debugging (e.g. “DurabilityKind”).

value: u32

Discriminator value that was read.

UnknownMustUnderstandMember

A mutable decode read a must_understand member with an unknown member ID (XTypes 1.3 §7.4.1.2.3 — the receiver MUST discard the message in that case).

Fields

member_id: u32

Member ID that was not recognized.

MissingNonOptionalMember

A mutable decode did not find a non-optional member in the wire data (XTypes 1.3 §7.4.1.2.3).

Fields

member_id: u32

Member ID that is missing.

Trait Implementations

impl Clone for DecodeError

fn clone(&self) -> DecodeError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DecodeError

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

Formats the value using the given formatter.

impl Display for DecodeError

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

Formats the value using the given formatter.

impl Eq for DecodeError

impl Error for DecodeError

Available on crate feature std only.

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 DecodeError

fn eq(&self, other: &DecodeError) -> 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 DecodeError