jzon-rs 0.2.1

Zero-copy JSON serialization with compile-time generated typed parsers
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

use std::fmt;

#[non_exhaustive]
#[derive(Debug, Clone, PartialEq)]
pub enum Error {
    UnexpectedEof,
    UnexpectedToken,
    MissingField(&'static str),
    InvalidNumber,
    InvalidUtf8,
    InvalidEscape,
    UnknownField,
    UnknownVariant,
    /// A `&str` field requested zero-copy but the JSON string has escape
    /// sequences — use `String` for that field to allow allocated unescaping.
    EscapedString,
    /// An object key contained escape sequences (extremely rare).
    EscapedKey,
    Custom(String),
}

impl fmt::Display for Error {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self {
            Error::UnexpectedEof    => write!(f, "unexpected end of JSON input"),
            Error::UnexpectedToken  => write!(f, "unexpected token in JSON input"),
            Error::MissingField(n)  => write!(f, "missing JSON field `{n}`"),
            Error::InvalidNumber    => write!(f, "invalid JSON number"),
            Error::InvalidUtf8      => write!(f, "invalid UTF-8 in JSON string"),
            Error::InvalidEscape    => write!(f, "invalid JSON escape sequence"),
            Error::UnknownField     => write!(f, "unknown JSON field (deny_unknown_fields)"),
            Error::UnknownVariant   => write!(f, "unknown enum variant"),
            Error::EscapedString    => write!(
                f,
                "string contains escape sequences — borrow is impossible; use `String`"
            ),
            Error::EscapedKey       => write!(f, "JSON object key contains escape sequences"),
            Error::Custom(m)        => write!(f, "{m}"),
        }
    }
}

impl std::error::Error for Error {}