Enum Error 

#[non_exhaustive]
pub enum Error {
    Malformed,
    NonDeterministic,
    UnexpectedEof,
    LengthTooLarge,
    NestingTooDeep,
    InvalidUtf8,
    InvalidHex,
    InvalidBase64,
    IncompatibleType(DataType),
    Overflow,
    NegativeUnsigned,
    Precision,
    InvalidSimpleValue,
    InvalidFormat,
    InvalidValue,
}

Errors produced by this crate.

Errors fall into three categories:

Decoding errors are returned when input cannot be parsed as a valid CBOR value, whether the input is binary, hex, or diagnostic notation. Produced by Value::decode, Value::decode_hex, Value::read_from, Value::read_hex_from, Value::from_str (via FromStr), and the iterators returned by DecodeOptions: Malformed, NonDeterministic, UnexpectedEof, LengthTooLarge, NestingTooDeep, InvalidUtf8, InvalidHex, InvalidBase64, InvalidFormat.

Malformed and NonDeterministic apply to binary and hex input; InvalidFormat is the catch-all for diagnostic-notation syntax errors and also signals trailing data after a complete single-item decode.

Accessor errors are returned by the to_*, as_*, and into_* methods on Value when the value does not match the requested type: IncompatibleType, Overflow, NegativeUnsigned, Precision, InvalidSimpleValue.

Validation errors are returned during construction of typed helpers like DateTime and EpochTime: InvalidFormat (reused from the decoding category) and InvalidValue.

Error is Copy, Eq, Ord, and Hash, so it can be matched, compared, and used as a map key without allocation. I/O errors are handled separately by IoError, which wraps either an Error or a std::io::Error. This separation keeps Error small and Copy-able while still supporting streaming operations that can fail with I/O problems.

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.

Malformed

Binary CBOR data is structurally broken.

NonDeterministic

CBOR encoding is valid but not deterministic (non-shortest form, unsorted map keys, etc.).

UnexpectedEof

Input ended before a complete data item was read.

LengthTooLarge

Declared length exceeds addressable memory or reasonable size.

NestingTooDeep

Nesting depth of arrays, maps, or tags exceeds the recursion limit.

InvalidUtf8

Text string contains invalid UTF-8.

InvalidHex

Hex input contains invalid characters.

InvalidBase64

Base64 input contains invalid characters.

IncompatibleType(DataType)

Accessor called on a value of the wrong CBOR type.

Overflow

Integer does not fit in the target type.

NegativeUnsigned

Attempted to read a negative integer as an unsigned type.

Precision

Float conversion would lose precision.

InvalidSimpleValue

Simple value number is in the reserved range 24-31.

InvalidFormat

Textual input did not match the expected syntax. Used for diagnostic-notation parse errors, trailing data after a single-item decode, and invalid date/time strings.

InvalidValue

A value violates semantic constraints.

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a duplicate 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 From<Error> for Error

Available on crate feature serde only.

fn from(error: Error) -> Self

Converts to this type from the input type.

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

fn from(error: Error) -> Self

Converts to this type from the input type.

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

fn from(error: Error) -> Self

Converts to this type from the input type.

impl From<FromUtf8Error> for Error

fn from(_error: FromUtf8Error) -> Self

Converts to this type from the input type.

impl Hash for Error

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for Error

fn cmp(&self, other: &Error) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

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

fn partial_cmp(&self, other: &Error) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Copy for Error

impl Eq for Error

impl StructuralPartialEq for Error