Struct ValueWireJsonError 

pub struct ValueWireJsonError { /* private fields */ }

Available on crate feature json only.

Privacy-safe classification and source position for a JSON wire failure.

Obtain this metadata from ValueWireDecodeError::InvalidJson rather than constructing it directly. It contains only the Serde category and source coordinates; it does not retain the input or detailed error message. A coordinate of zero means that the source position is unavailable, as can happen for target-type failures after decoding through a unique-key tree. Direct conversion from a Serde error preserves its source coordinates.

Examples

use qubit_value::ValueWireDecodeError;
use qubit_value::ValueWireJsonError;
use serde_json::error::Category;

fn check_metadata(metadata: &ValueWireJsonError) {
    assert_eq!(metadata.classify(), Category::Data);
    assert!(metadata.is_data());
    assert!(metadata.line() > 0);
    assert!(metadata.column() > 0);
}

let source = serde_json::from_str::<u64>(r#""not a number""#).unwrap_err();
let error = ValueWireDecodeError::from(source);
let ValueWireDecodeError::InvalidJson(metadata) = error else {
    panic!("direct Serde conversion must preserve safe metadata");
};
check_metadata(&metadata);

Implementations

impl ValueWireJsonError

pub fn classify(&self) -> Category

Returns the Serde JSON failure category.

Returns

The category associated with the failure.

pub fn line(&self) -> usize

Returns the one-based input line, or zero when unavailable.

Returns

The source line, or zero if no source position is available.

pub fn column(&self) -> usize

Returns the one-based input column, or zero when unavailable.

Returns

The source column, or zero if no source position is available.

pub fn is_io(&self) -> bool

Returns whether the error is an I/O failure.

Returns

true if the category is Category::Io; otherwise, false.

pub fn is_syntax(&self) -> bool

Returns whether the error is a JSON syntax failure.

Returns

true if the category is Category::Syntax; otherwise, false.

pub fn is_data(&self) -> bool

Returns whether the JSON data has an incompatible type or value.

Returns

true if the category is Category::Data; otherwise, false.

pub fn is_eof(&self) -> bool

Returns whether the JSON input ended before decoding completed.

Returns

true if the category is Category::Eof; otherwise, false.

Trait Implementations

impl Debug for ValueWireJsonError

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

Formats the value using the given formatter.

impl Display for ValueWireJsonError

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

Writes the failure category and coordinates without exposing input data.

Parameters

• formatter: Destination for the privacy-safe diagnostic.

Returns

Success after writing the diagnostic.

Errors

Returns the destination’s formatting error if writing fails.

impl Error for ValueWireJsonError

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.