Enum JcsDecodeError 

pub enum JcsDecodeError<R = JsonResource, Q = usize>
where
    Q: Copy + Debug,
{
    Decode(JsonDecodeError<R, Q>),
    DuplicateKey {
        line: usize,
        column: usize,
    },
    MaterializationDepthLimit {
        limit: usize,
        line: usize,
        column: usize,
    },
}

JCS decoding failure with explicit duplicate-key handling.

Type Parameters

• R - Resource identity used by the wrapped budget error.
• Q - Quantity representation used for resource accounting.

Examples

use qubit_json::decode::{JcsDecodeError, JcsDecoder};

let error = JcsDecoder::unlimited()
    .decode_str(r#"{"x":1,"x":2}"#)
    .expect_err("duplicate keys must be rejected");
assert!(matches!(error, JcsDecodeError::DuplicateKey { .. }));

Variants

Decode(JsonDecodeError<R, Q>)

An input, UTF-8, budget, or lexical admission failure.

Tuple Fields

0: JsonDecodeError<R, Q>

Shared decode error with stable category and input diagnostics.

DuplicateKey

An object contains two keys equal after JSON escape decoding.

Fields

line: usize

One-based source line of the second key token.

column: usize

One-based UTF-8 character column of the second key token.

MaterializationDepthLimit

Historical compatibility variant; the shared builder no longer emits it.

Fields

limit: usize

Maximum number of nested containers accepted during construction.

line: usize

One-based source line where the first over-limit container begins.

column: usize

One-based UTF-8 character column of that container token.

Trait Implementations

impl<R: Clone, Q> Clone for JcsDecodeError<R, Q>

where Q: Copy + Debug + Clone,

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<R: Debug, Q> Debug for JcsDecodeError<R, Q>

where Q: Copy + Debug + Debug,

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

Formats the value using the given formatter.

impl<R, Q> Display for JcsDecodeError<R, Q>

where R: Debug, Q: ResourceQuantity,

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

Formats the decoding failure with its source location when applicable.

Parameters

• formatter - Destination that receives the formatted message.

Returns

Ok(()) after the message is written.

Errors

Returns the formatter error if writing the message fails.

impl<R, Q> Error for JcsDecodeError<R, Q>

where R: Debug + 'static, Q: ResourceQuantity + 'static,

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the wrapped decoding error for the standard error chain.

Returns

The wrapped decode error for Decode, or None for the JCS-specific duplicate-key and construction-depth failures.

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<R, Q> From<JsonDecodeError<R, Q>> for JcsDecodeError<R, Q>

where Q: Copy + Debug,

fn from(error: JsonDecodeError<R, Q>) -> Self

Wraps a regular decoding failure as a JCS decoding failure.

Parameters

• error - Regular decoding failure to wrap.

Returns

A JCS error containing the supplied decoding failure.