Enum Error

#[non_exhaustive]
pub enum Error {
    AnyIsUnsupported,
    BytesIsUnsupported,
    EofWhileParsingList,
    EofWhileParsingObject,
    EofWhileParsingString,
    EofWhileParsingNumber,
    EofWhileParsingValue,
    ExpectedColon,
    ExpectedListCommaOrEnd,
    ExpectedObjectCommaOrEnd,
    ExpectedSomeIdent,
    ExpectedSomeValue,
    InvalidNumber,
    InvalidType,
    InvalidUnicodeCodePoint,
    InvalidEscapeSequence,
    EscapedStringIsTooLong,
    KeyMustBeAString,
    TrailingCharacters,
    TrailingComma,
    CustomError,
}

This type represents all possible errors that can occur when deserializing JSON data

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.

AnyIsUnsupported

Can’t parse a value without knowing its expected type.

BytesIsUnsupported

Cannot parse a sequence of bytes.

EofWhileParsingList

EOF while parsing a list.

EofWhileParsingObject

EOF while parsing an object.

EofWhileParsingString

EOF while parsing a string.

EofWhileParsingNumber

EOF while parsing a JSON number.

EofWhileParsingValue

EOF while parsing a JSON value.

ExpectedColon

Expected this character to be a ':'.

ExpectedListCommaOrEnd

Expected this character to be either a ',' or a ']'.

ExpectedObjectCommaOrEnd

Expected this character to be either a ',' or a '}'.

ExpectedSomeIdent

Expected to parse either a true, false, or a null.

ExpectedSomeValue

Expected this character to start a JSON value.

InvalidNumber

Invalid number.

InvalidType

Invalid type

InvalidUnicodeCodePoint

Invalid unicode code point.

InvalidEscapeSequence

Invalid String Escape Sequence

EscapedStringIsTooLong

Escaped String length exceeds buffer size

KeyMustBeAString

Object key is not a string.

TrailingCharacters

JSON has non-whitespace trailing characters after the value.

TrailingComma

JSON has a comma after the last value in an array or map.

CustomError

Error with a custom message that we had to discard.

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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 Error for Error

fn custom<T>(msg: T) -> Self

where T: Display,

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 From<StringUnescapeError> for Error

fn from(error: StringUnescapeError) -> Self

Converts to this type from the input type.

impl PartialEq for Error

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

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for Error

impl Eq for Error

impl StructuralPartialEq for Error