Enum ValueError 

#[non_exhaustive]
pub enum ValueError {
    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::UnsetScalar {
    data_type: DataType::String,
});
assert_eq!(error.to_string(), "Missing value: unset scalar with declared type 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.

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.

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

Returns the structured missing-value reason, when present.

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: &ValueError) -> bool

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ValueError