Enum bincode_core::DeserializeError

pub enum DeserializeError<'a, R: CoreRead<'a>> {
    Read(R::Error),
    InvalidBoolValue(u8),
    InvalidCharEncoding,
    Utf8(Utf8Error),
    InvalidOptionValue(u8),
    LimitError(LimitError),
    InvalidCast {
        from_type: &'static str,
        to_type: &'static str,
    },
    InvalidUtf8Encoding(Utf8Error),
    InvalidValueRange,
    ExtensionPoint,
}

Errors that can occur while deserializing

Variants

Read(R::Error)

Failed to read from the provided CoreRead. The inner exception is given.

InvalidBoolValue(u8)

Invalid bool value. Only 0 and 1 are valid values.

InvalidCharEncoding

Invalid character encoding while trying to deserialize a &str.

Utf8(Utf8Error)

UTF8 error while trying to deserialize a &str

InvalidOptionValue(u8)

Invalid value for the Option part of Option<T>. Only 0 and 1 are accepted values.

LimitError(LimitError)

Limit error reached. See the inner exception for more info.

InvalidCast

Could not cast from type from_type to type to_type. Usually this means that the data is encoded with a different version or protocol.

Fields of InvalidCast

from_type: &'static str

The base type that was being casted from

to_type: &'static str

The target type that was being casted to

InvalidUtf8Encoding(Utf8Error)

Invalid UTF8 encoding while trying to parse a &str or String

InvalidValueRange

Invalid value (u128 range): you may have a version or configuration disagreement?

ExtensionPoint

Byte 255 is treated as an extension point; it should not be encoding anything. Do you have a mismatched bincode version or configuration?

Trait Implementations

impl<'a, R: CoreRead<'a>> Debug for DeserializeError<'a, R>

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

Formats the value using the given formatter.

impl<'a, R: CoreRead<'a>> Display for DeserializeError<'a, R>

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

Formats the value using the given formatter.

impl<'a, R: CoreRead<'a>> Error for DeserializeError<'a, R>

pub fn source(&self) -> Option<&(dyn Error + 'static)>

The lower-level source of this error, if any.

pub fn backtrace(&self) -> Option<&Backtrace>

🔬 This is a nightly-only experimental API. (backtrace)

Returns a stack backtrace, if available, of where this error occurred.

pub fn description(&self) -> &str

👎 Deprecated since 1.42.0:

use the Display impl or to_string()

pub fn cause(&self) -> Option<&dyn Error>

👎 Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

impl<'a, R: CoreRead<'a>> Error for DeserializeError<'a, R>

fn custom<T: Display>(_cause: T) -> Self

Raised when there is general error when deserializing a type.

pub fn invalid_type(unexp: Unexpected<'_>, exp: &dyn Expected) -> Self

Raised when a Deserialize receives a type different from what it was expecting.

pub fn invalid_value(unexp: Unexpected<'_>, exp: &dyn Expected) -> Self

Raised when a Deserialize receives a value of the right type but that is wrong for some other reason.

pub fn invalid_length(len: usize, exp: &dyn Expected) -> Self

Raised when deserializing a sequence or map and the input data contains too many or too few elements.

pub fn unknown_variant(variant: &str, expected: &'static [&'static str]) -> Self

Raised when a Deserialize enum type received a variant with an unrecognized name.

pub fn unknown_field(field: &str, expected: &'static [&'static str]) -> Self

Raised when a Deserialize struct type received a field with an unrecognized name.

pub fn missing_field(field: &'static str) -> Self

Raised when a Deserialize struct type expected to receive a required field with a particular name but that field was not present in the input.

pub fn duplicate_field(field: &'static str) -> Self

Raised when a Deserialize struct type received more than one of the same field.

impl<'a, R: CoreRead<'a>> From<Utf8Error> for DeserializeError<'a, R>

fn from(err: Utf8Error) -> Self

Performs the conversion.