Enum Error

pub enum Error<T> {
    Io(T),
    Syntax(usize),
    Semantic(Option<usize>, String),
    RecursionLimitExceeded,
}

An error occurred during deserialization

Variants

Io(T)

An error occurred while reading bytes

Contains the underlying error returned while reading.

Syntax(usize)

An error occurred while parsing bytes

Contains the offset into the stream where the syntax error occurred.

Semantic(Option<usize>, String)

An error occurred while processing a parsed value

Contains a description of the error that occurred and (optionally) the offset into the stream indicating the start of the item being processed when the error occurred.

RecursionLimitExceeded

The input caused serde to recurse too much

This error prevents a stack overflow.

Implementations

impl<T> Error<T>

pub fn semantic( offset: impl Into<Option<usize>>, msg: impl Into<String>, ) -> Self

A helper method for composing a semantic error

Trait Implementations

impl<T: Debug> Debug for Error<T>

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

Formats the value using the given formatter.

impl<T: Debug> Display for Error<T>

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

Formats the value using the given formatter.

impl<T: Debug> Error for Error<T>

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<T: Debug> Error for Error<T>

fn custom<U: Display>(msg: U) -> Self

Raised when there is general error when deserializing a type.

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

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

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.

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.

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

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

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

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

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.

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

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

impl<T> From<Error<T>> for Error<T>

fn from(value: Error<T>) -> Self

Converts to this type from the input type.

impl<T> From<T> for Error<T>

fn from(value: T) -> Self

Converts to this type from the input type.

Layout

Note: Unable to compute type layout, possibly due to this type having generic parameters. Layout can only be computed for concrete, fully-instantiated types.