Struct DecodeError 

#[non_exhaustive]
pub struct DecodeError { /* private fields */ }

A JSON document could not be decoded into the expected type.

The error deliberately carries no part of the input. A decoded document may contain application state and therefore personal data, and both the codec’s own error text and serde’s type-mismatch messages quote the input. What is kept is the kind, the position and the field path, which are derived from the expected type rather than from the values.

Implementations

impl DecodeError

pub fn kind(&self) -> DecodeErrorKind

Which of the three failure classes this is.

pub fn line(&self) -> usize

The one-based line the parser stopped at, or 0 when the document was rejected before it was parsed.

pub fn column(&self) -> usize

The one-based column the parser stopped at, or 0 when the document was rejected before it was parsed.

pub fn path(&self) -> &str

The path of the offending field, with dotted names and bracketed indices, for example answers.tone.confidence or models[1].name.

The path of the document root is ., and it is empty when the failure carries no path at all.

A name in the path may be an object key the input chose, so it is rendered safe to print: a control character or a format character that reorders or hides text is written as a Rust escape (\n, \u{1b}, \u{202e}), a backslash is written \\ so that an escape cannot be mistaken for text, and other printable text, non-ASCII included, is kept as it is. Each name is cut at 128 characters and the whole path at 320, counted after escaping, and a cut is marked with U+2026.

Trait Implementations

impl Clone for DecodeError

fn clone(&self) -> Self

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 From<DecodeError> for ContentError

fn from(source: DecodeError) -> Self

Converts to this type from the input type.

impl PartialEq for DecodeError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for DecodeError