Enum ValueWireEncodeError 

#[non_exhaustive]
pub enum ValueWireEncodeError {
    JsonNumberNotRoundTrippable,
    NonFiniteFloat {
        data_type: DataType,
    },
    BigDecimalScaleTooLarge {
        scale: i64,
        maximum_absolute_scale: i64,
    },
    InstantYearOutOfRange {
        year: i32,
    },
    Budget(BudgetError<JsonResource, usize>),
    Quantity {
        resource: JsonResource,
        source: QuantityConversionError,
    },
    Syntax(JsonSyntaxError),
    Json(JsonSerializationError),
    Io(Error),
}

A runtime value cannot be represented by the JSON V1 wire contract.

Examples

use qubit_value::Value;
use qubit_value::ValueWireEncodeError;
use qubit_value::ValueWireV1;

let error = ValueWireV1::try_from(Value::Float64(f64::NAN)).unwrap_err();
assert!(matches!(error, ValueWireEncodeError::NonFiniteFloat { .. }));

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.

JsonNumberNotRoundTrippable

Available on crate feature json only.

A JSON number cannot be restored with the V1 number model without changing its serde_json::Number identity.

NonFiniteFloat

A JSON V1 float must be finite.

Fields

data_type: DataType

Runtime data type of the rejected value.

BigDecimalScaleTooLarge

A V1 decimal exponent must stay within the bounded wire range.

Fields

scale: i64

Rejected decimal exponent.

maximum_absolute_scale: i64

Inclusive exponent magnitude limit for V1.

InstantYearOutOfRange

A UTC instant year must be within the four-digit V1 wire range.

Fields

year: i32

UTC calendar year rejected by the V1 wire contract.

Budget(BudgetError<JsonResource, usize>)

Available on crate feature json only.

The JSON output exceeded one configured resource budget.

Tuple Fields

0: BudgetError<JsonResource, usize>

Budget violation reported by the bounded JSON encoder.

Quantity

Available on crate feature json only.

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)

Available on crate feature json only.

The encoded value contains invalid JSON syntax.

Tuple Fields

0: JsonSyntaxError

Syntax error found in an embedded raw JSON payload.

Json(JsonSerializationError)

Available on crate feature json only.

Strict JSON serialization rejected the value during bounded encoding.

Tuple Fields

0: JsonSerializationError

Stable, privacy-safe JSON serialization failure.

Io(Error)

Available on crate feature json only.

The destination writer rejected bounded JSON output.

Tuple Fields

0: Error

Destination-writer failure.

Trait Implementations

impl Debug for ValueWireEncodeError

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

Formats the value using the given formatter.

impl Display for ValueWireEncodeError

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

Formats the value using the given formatter.

impl Error for ValueWireEncodeError

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<JsonEncodeError<JsonResource>> for ValueWireEncodeError

Available on crate feature json only.

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

Converts bounded JSON encoder failures into wire encoding errors.

Resource-budget failures retain their budget details, invalid raw JSON retains its syntax error, and serialization or writer failures retain their corresponding source errors.

Parameters

• error - Failure reported by the bounded JSON encoder.

Returns

The wire encoding error corresponding to the encoder failure.

impl From<MeasuredBudgetError<JsonResource, usize>> for ValueWireEncodeError

Available on crate feature json only.

fn from(error: MeasuredBudgetError<JsonResource, usize>) -> Self

Converts a measured budget failure into its corresponding wire error.

Budget violations retain their budget details, while quantity conversion failures retain the affected resource and source error.

Parameters

• error - Measured failure reported by the budget layer.

Returns

The wire encoding error corresponding to the measured failure.