Enum ValueError 

#[non_exhaustive]
pub enum ValueError {
    JsonProjectionLimit {
        data_type: DataType,
        source_index: Option<usize>,
        source: MeasuredBudgetError<ConversionResource, u64>,
    },
    Missing(ValueMissing),
    TypeMismatch {
        expected: DataType,
        actual: DataType,
    },
    Conversion(DataConversionError),
    ListConversion(DataListConversionError),
}

Value processing error type

Defines various error conditions that may occur during value operations. Downstream matches must include a wildcard arm because this enum is non-exhaustive and may gain new error variants.

Features

• Type mismatch error
• Structured missing-value errors
• Structured single-value conversion errors when converter is enabled
• Structured list conversion errors, including the failing item index, when converter is enabled

Examples

use qubit_datatype::DataType;
use qubit_value::{ValueError, ValueMissing};

let error = ValueError::Missing(ValueMissing::unset_scalar(DataType::String, DataType::String));
assert_eq!(error.missing().unwrap().target_type(), Some(DataType::String));

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.

JsonProjectionLimit

Resource rejection before materializing a natural JSON projection.

Fields

data_type: DataType

Runtime scalar or collection element type being projected.

source_index: Option<usize>

Collection element index, or None for a scalar or outer shape.

source: MeasuredBudgetError<ConversionResource, u64>

Exact rejected resource measurement, including its configured bound.

Missing(ValueMissing)

No concrete item is available from typed runtime storage or conversion.

Tuple Fields

0: ValueMissing

Structured typed storage state that caused the missing value.

TypeMismatch

Type mismatch

Fields

expected: DataType

Expected data type

actual: DataType

Actual data type

Conversion(DataConversionError)

Error returned by the shared single-value conversion layer.

Tuple Fields

0: DataConversionError

Structured conversion failure from qubit-datatype.

ListConversion(DataListConversionError)

Error returned by the shared list conversion layer.

Tuple Fields

0: DataListConversionError

Structured list conversion failure, including the source index.

Implementations

impl ValueError

pub const fn is_missing(&self) -> bool

Reports whether this error describes a missing value.

Returns

true only for Self::Missing.

pub const fn missing(&self) -> Option<&ValueMissing>

Returns the structured missing-value reason, when present.

Returns

Some(reason) for Self::Missing and None for every other variant.

Trait Implementations

impl Clone for ValueError

fn clone(&self) -> ValueError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ValueError

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

Formats the value using the given formatter.

impl Display for ValueError

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

Formats the value using the given formatter.

impl Eq for ValueError

impl Error for ValueError

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<DataConversionError> for ValueError

Available on crate feature converter only.

fn from(error: DataConversionError) -> Self

Converts to this type from the input type.

impl From<DataListConversionError> for ValueError

Available on crate feature converter only.

fn from(error: DataListConversionError) -> Self

Converts to this type from the input type.

impl PartialEq for ValueError

fn eq(&self, other: &Self) -> bool

Compares structured error facts without depending on diagnostic text.

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

Inequality operator !=.