Enum DataConversionError 

pub enum DataConversionError {
    Missing {
        from: DataType,
        to: DataType,
    },
    EmptyCollection {
        to: DataType,
    },
    Unsupported {
        from: DataType,
        to: DataType,
    },
    InvalidValue {
        from: DataType,
        to: DataType,
        reason: InvalidValueReason,
    },
}

Describes why a single source value could not be converted.

Value conversion variants record both the declared source and requested target DataType. Self::EmptyCollection records only the requested target because an empty generic collection has no source value whose type can be observed. Invalid-value errors additionally carry a stable, value-independent InvalidValueReason. Source values are deliberately not retained or formatted, which makes these errors safe to surface for secrets such as environment variables.

Examples

use qubit_datatype::{DataConversionError, DataConverter, InvalidValueReason};

assert!(matches!(
    DataConverter::from("not-a-number").to::<u32>(),
    Err(DataConversionError::InvalidValue {
        reason: InvalidValueReason::InvalidSyntax { .. },
        ..
    }),
));

Variants

Missing

The source has no concrete value.

Fields

from: DataType

Source data type.

to: DataType

Requested target data type.

EmptyCollection

A first-value conversion was requested from an empty collection.

Fields

to: DataType

Requested target data type.

Unsupported

The source and target type pair is unsupported.

Fields

from: DataType

Source data type.

to: DataType

Requested target data type.

InvalidValue

The type pair is supported but the source value is invalid.

Fields

from: DataType

Source data type.

to: DataType

Requested target data type.

reason: InvalidValueReason

Value-free reason for rejection.

Trait Implementations

impl Clone for DataConversionError

fn clone(&self) -> DataConversionError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DataConversionError

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

Formats the value using the given formatter.

impl Display for DataConversionError

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

Formats the value using the given formatter.

impl Eq for DataConversionError

impl Error for DataConversionError

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

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for DataConversionError