Enum DecodeError 

pub enum DecodeError {
    UnknownKind(String),
    Malformed {
        codec: &'static str,
        message: String,
        cause: Option<BoxedCause>,
    },
    WrongEncoding(String),
    BadSchema {
        message: String,
        cause: Option<BoxedCause>,
    },
    Encode {
        message: String,
        cause: Option<BoxedCause>,
    },
}

Available on crate features decode and schema only.

A decode/encode failure.

The three variants that wrap a codec’s own error carry it boxed rather than stringified (#317). Three codecs means three unrelated error types (serde_json, ciborium, prost), so the box is what lets one variant hold any of them; Display is unchanged, because it still prints the inner error’s Display — what changes is that source() now reaches it.

Variants

UnknownKind(String)

Malformed

Fields

codec: &'static str

message: String

cause: Option<BoxedCause>

WrongEncoding(String)

BadSchema

Fields

message: String

cause: Option<BoxedCause>

Encode

Fields

message: String

cause: Option<BoxedCause>

Implementations

impl DecodeError

pub fn malformed(codec: &'static str, cause: impl Into<BoxedCause>) -> Self

A codec refused the bytes — its error is the cause.

pub fn malformed_here(codec: &'static str, message: impl Into<String>) -> Self

This crate refused the bytes: there is no underlying error, and source() says so rather than inventing one.

pub fn bad_schema(message: impl Into<String>) -> Self

A schema entry this build cannot use, explained by this crate.

pub fn bad_schema_from(cause: impl Into<BoxedCause>) -> Self

A schema entry a validator rejected — its error is the cause.

pub fn encode(cause: impl Into<BoxedCause>) -> Self

An encode failure from a codec.

pub fn encode_here(message: impl Into<String>) -> Self

An encode refusal this crate made itself.

Trait Implementations

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, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for DecodeError

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.