Enum DecodeError 

#[non_exhaustive]
pub enum DecodeError {
    NoDecoderForType {
        column: String,
    },
    NotYetImplemented {
        decoder: &'static str,
    },
    InvalidUtf8 {
        column: String,
    },
    InvalidUuid {
        column: String,
        source_len: usize,
    },
    InvalidHexEscape {
        column: String,
        at: usize,
    },
    IntegerOverflow {
        column: String,
        digits: String,
    },
    DecimalPrecisionLoss {
        column: String,
    },
    JsonNotSerializable {
        column: String,
        error: String,
    },
    WrongPayloadKind {
        column: String,
        expected: &'static str,
        actual: &'static str,
    },
    Custom {
        column: String,
        message: String,
    },
}

Failure modes shared across every wire::Decoder implementation.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

NoDecoderForType

The TypeMap contains no decoder for the wire type carried by this column.

Fields

column: String

Column whose type was unrecognized.

NotYetImplemented

The decoder skeleton exists but its implementation is not yet populated.

Fields

decoder: &'static str

The unpopulated decoder’s type name.

InvalidUtf8

Column payload was expected to be valid UTF-8 and was not.

Fields

column: String

Offending column name.

InvalidUuid

Column payload did not parse as a UUID (36-char hyphenated or braced form).

Fields

column: String

Offending column name.

source_len: usize

Length of the string the decoder tried to parse.

InvalidHexEscape

Column payload was expected to be a \xHEX PG BYTEA escape and contained an invalid character at the reported byte offset.

Fields

column: String

Offending column name.

at: usize

Zero-based byte offset of the first invalid character.

IntegerOverflow

Integer payload exceeded i64 range and its shape (MySQL bigint unsigned, PG numeric cast, …) did not permit a silent fallback to Text.

Fields

column: String

Offending column name.

digits: String

The raw digit string as received on the wire.

DecimalPrecisionLoss

Column carried a decimal that was delivered as a JSON number, which cannot preserve precision above ~15 significant digits.

Fields

column: String

Offending column name.

JsonNotSerializable

JSON payload failed to serialize into the target text form. Only observable when a JSON decoder receives a value that serde_json cannot round-trip through to_string.

Fields

column: String

Offending column name.

error: String

serde_json error message.

WrongPayloadKind

Payload kind was not what this decoder expected. Emitted when a decoder registered for one shape (e.g. JSON string) receives a different one (e.g. JSON object).

Fields

column: String

Offending column name.

expected: &'static str

Expected payload kind name.

actual: &'static str

Actual payload kind name.

Custom

Free-form failure emitted by user-supplied decoders.

Fields

column: String

Offending column name.

message: String

Failure message from the decoder.

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

Formats the value using the given formatter.

impl Eq for DecodeError

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.

impl PartialEq for DecodeError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for DecodeError