Trait Cast 

pub trait Cast {
    type Output;

    // Required method
    fn cast(&self, target_dtype: &DType) -> VortexResult<Self::Output>;
}

Trait for casting vectors and scalars to different data types.

Nullability Requirements

Casting a source that contains null values to a non-nullable target dtype will return an error. This invariant is not checked by the common helper functions, so each implementation is responsible for enforcing it.

Common Casting Behaviors

All implementations share these behaviors:

• Identity: Casting to the same dtype (with compatible nullability) returns a clone.
• Null casting: Any all-null vector can be cast to DType::Null, and any null scalar can be cast to a NullScalar.
• Extension types: Casting to an extension type delegates to casting to its storage dtype.

Required Associated Types

type Output

The output type after casting.

Required Methods

fn cast(&self, target_dtype: &DType) -> VortexResult<Self::Output>

Cast the vector or scalar to the specified data type.

Implementations on Foreign Types

impl Cast for Datum

fn cast(&self, target_dtype: &DType) -> VortexResult<Datum>

Dispatches to the contained Scalar or Vector cast implementation.

type Output = Datum

impl Cast for DecimalScalar

fn cast(&self, target_dtype: &DType) -> VortexResult<Scalar>

Dispatches to the underlying DScalar<D> implementation.

type Output = Scalar

impl Cast for DecimalVector

fn cast(&self, target_dtype: &DType) -> VortexResult<Vector>

Dispatches to the underlying DVector<D> implementation.

type Output = Vector

impl Cast for PrimitiveScalar

fn cast(&self, target_dtype: &DType) -> VortexResult<Scalar>

Dispatches to the underlying PScalar<T> implementation.

type Output = Scalar

impl Cast for PrimitiveVector

fn cast(&self, target_dtype: &DType) -> VortexResult<Vector>

Dispatches to the underlying PVector<T> implementation.

type Output = Vector

impl Cast for Scalar

fn cast(&self, target_dtype: &DType) -> VortexResult<Scalar>

Dispatches to the underlying typed scalar implementation.

type Output = Scalar

impl Cast for Vector

fn cast(&self, target_dtype: &DType) -> VortexResult<Vector>

Dispatches to the underlying typed vector implementation.

type Output = Vector

impl Cast for BoolScalar

fn cast(&self, target_dtype: &DType) -> VortexResult<Scalar>

Casts to Bool (identity) or Primitive (as 0/1).

type Output = Scalar

impl Cast for BoolVector

fn cast(&self, target_dtype: &DType) -> VortexResult<Vector>

Casts to Bool (identity) or Primitive (as 0/1).

type Output = Vector

impl Cast for FixedSizeListScalar

fn cast(&self, target_dtype: &DType) -> VortexResult<Scalar>

Casts to FixedSizeList (identity with same element dtype, size, and compatible nullability).

type Output = Scalar

impl Cast for FixedSizeListVector

fn cast(&self, target_dtype: &DType) -> VortexResult<Vector>

Casts to FixedSizeList (identity with same element dtype, size, and compatible nullability).

type Output = Vector

impl Cast for ListViewScalar

fn cast(&self, target_dtype: &DType) -> VortexResult<Scalar>

Casts to List (identity with same element dtype and compatible nullability).

type Output = Scalar

impl Cast for ListViewVector

fn cast(&self, target_dtype: &DType) -> VortexResult<Vector>

Casts to List (identity with same element dtype and compatible nullability).

type Output = Vector

impl Cast for NullScalar

fn cast(&self, target_dtype: &DType) -> VortexResult<Scalar>

Casts to any nullable target type by creating a null scalar.

type Output = Scalar

impl Cast for NullVector

fn cast(&self, target_dtype: &DType) -> VortexResult<Vector>

Casts to any nullable target type by creating an all-null vector.

type Output = Vector

impl Cast for StructScalar

fn cast(&self, target_dtype: &DType) -> VortexResult<Scalar>

Casts to Struct (identity with same fields and compatible nullability).

type Output = Scalar

impl Cast for StructVector

fn cast(&self, target_dtype: &DType) -> VortexResult<Vector>

Casts to Struct (identity with same fields and compatible nullability).

type Output = Vector

impl<D: NativeDecimalType> Cast for DVector<D>

fn cast(&self, target_dtype: &DType) -> VortexResult<Vector>

Casts to Decimal with potentially different precision and native type.

type Output = Vector

impl<D: NativeDecimalType> Cast for DScalar<D>

fn cast(&self, target_dtype: &DType) -> VortexResult<Scalar>

Casts to Decimal (identity with same precision/scale and compatible nullability).

type Output = Scalar

impl<T: NativePType> Cast for PVector<T>

fn cast(&self, target_dtype: &DType) -> VortexResult<Vector>

Cast a primitive vector to a different primitive type.

type Output = Vector

impl<T: NativePType> Cast for PScalar<T>

fn cast(&self, target_dtype: &DType) -> VortexResult<Scalar>

Cast a primitive scalar to a different primitive type.

type Output = Scalar

impl<T: BinaryViewType> Cast for BinaryViewScalar<T>

fn cast(&self, target_dtype: &DType) -> VortexResult<Scalar>

Casts to Utf8 or Binary (identity cast with compatible nullability).

type Output = Scalar

impl<T: BinaryViewType> Cast for BinaryViewVector<T>

fn cast(&self, target_dtype: &DType) -> VortexResult<Vector>

Casts to Utf8 or Binary (identity cast with compatible nullability).

type Output = Vector

Implementors