Enum ValueWireDecodeError 

#[non_exhaustive]
pub enum ValueWireDecodeError {
    Read {
        kind: ErrorKind,
        source: Option<Arc<Error>>,
    },
    Budget(BudgetError<JsonResource, usize>),
    Quantity {
        resource: JsonResource,
        source: QuantityConversionError,
    },
    Syntax(JsonSyntaxError),
    UnsupportedVersion {
        expected: u8,
        actual: u8,
    },
    InvalidJson(ValueWireJsonError),
}

Available on crate feature json only.

Error produced by a bounded crate::ValueWireV1 JSON decoder.

Examples

use qubit_value::{ValueWireDecodeError, ValueWireV1};

let error = ValueWireV1::decode_json_slice(b"{").unwrap_err();
assert!(matches!(
    error,
    ValueWireDecodeError::Syntax(_) | ValueWireDecodeError::InvalidJson(_)
));

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.

Read

Reading the JSON wire input failed.

Fields

kind: ErrorKind

Stable standard I/O failure category.

source: Option<Arc<Error>>

Reference-counted original error retained under detailed diagnostics (Some), or absent under privacy-safe diagnostics (None).

Budget(BudgetError<JsonResource, usize>)

The JSON document exceeded one configured resource budget.

Tuple Fields

0: BudgetError<JsonResource, usize>

Budget violation reported by the bounded JSON decoder.

Quantity

A native JSON measurement could not be represented by the budget quantity type.

Fields

resource: JsonResource

Resource whose measurement failed.

source: QuantityConversionError

Native measurement conversion failure.

Syntax(JsonSyntaxError)

The bounded input contains JSON syntax errors with source location.

Tuple Fields

0: JsonSyntaxError

Syntax error with its source location preserved.

UnsupportedVersion

The envelope declares a wire version that this decoder does not support.

Fields

expected: u8

Wire version accepted by this decoder.

actual: u8

Wire version declared by the input envelope.

InvalidJson(ValueWireJsonError)

The bounded input is not a valid V1 JSON wire value.

Tuple Fields

0: ValueWireJsonError

Safe Serde JSON metadata without the original detailed error.

Trait Implementations

impl Debug for ValueWireDecodeError

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

Formats the value using the given formatter.

impl Display for ValueWireDecodeError

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

Formats the value using the given formatter.

impl Error for ValueWireDecodeError

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 ValueWireDecodeError

fn from(error: JsonError) -> Self

Converts a Serde JSON error while preserving its category and location.

The formatted diagnostic does not retain the input contents.

Parameters

• error - Serde JSON decoding failure.

Returns

An invalid-JSON wire error with a privacy-safe diagnostic.

impl From<JsonDecodeError> for ValueWireDecodeError

fn from(error: JsonDecodeError<JsonResource>) -> Self

Converts bounded decoder failures into the corresponding wire error.

Decoder resource violations retain their structured details, syntax failures retain their source location, and other malformed inputs are represented by a privacy-safe deserialization error.

Parameters

• error - Failure returned by the bounded JSON decoder.

Returns

The corresponding value-wire decoding error.