Trait ArrowBindingView 

pub trait ArrowBindingView {
    type Array: Array;
    type View<'a>
       where Self: 'a;

    // Required method
    fn get_view(
        array: &Self::Array,
        index: usize,
    ) -> Result<Self::View<'_>, ViewAccessError>;
}

View binding from an Arrow array to borrowed Rust reference types.

Implementations of this trait provide zero-copy access to Arrow array values by returning borrowed references with a lifetime tied to the array.

Note: This trait is separate from ArrowBinding to allow types to opt-in to view support. Complex types like List, Map, etc. may not implement this.

Required Associated Types

type Array: Array

The Arrow array type this view reads from.

type View<'a> where Self: 'a

The borrowed view type returned when accessing array elements. For example: &'a str for StringArray, i64 for Int64Array.

Required Methods

fn get_view( array: &Self::Array, index: usize, ) -> Result<Self::View<'_>, ViewAccessError>

Extract a view at the given index from the array.

Errors

• Returns ViewAccessError::OutOfBounds if index >= array.len()
• Returns ViewAccessError::UnexpectedNull if the value is null
• Returns ViewAccessError::TypeMismatch if array downcast fails

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementations on Foreign Types

impl ArrowBindingView for bool

Available on crate feature views only.

type Array = BooleanArray

type View<'a> = bool

fn get_view( array: &Self::Array, index: usize, ) -> Result<Self::View<'_>, ViewAccessError>

impl ArrowBindingView for f32

Available on crate feature views only.

type Array = PrimitiveArray<Float32Type>

type View<'a> = f32

fn get_view( array: &Self::Array, index: usize, ) -> Result<Self::View<'_>, ViewAccessError>

impl ArrowBindingView for f64

Available on crate feature views only.

type Array = PrimitiveArray<Float64Type>

type View<'a> = f64

fn get_view( array: &Self::Array, index: usize, ) -> Result<Self::View<'_>, ViewAccessError>

impl ArrowBindingView for i8

Available on crate feature views only.

type Array = PrimitiveArray<Int8Type>

type View<'a> = i8

fn get_view( array: &Self::Array, index: usize, ) -> Result<Self::View<'_>, ViewAccessError>

impl ArrowBindingView for i16

Available on crate feature views only.

type Array = PrimitiveArray<Int16Type>

type View<'a> = i16

fn get_view( array: &Self::Array, index: usize, ) -> Result<Self::View<'_>, ViewAccessError>

impl ArrowBindingView for i32

Available on crate feature views only.

type Array = PrimitiveArray<Int32Type>

type View<'a> = i32

fn get_view( array: &Self::Array, index: usize, ) -> Result<Self::View<'_>, ViewAccessError>

impl ArrowBindingView for i64

Available on crate feature views only.

type Array = PrimitiveArray<Int64Type>

type View<'a> = i64

fn get_view( array: &Self::Array, index: usize, ) -> Result<Self::View<'_>, ViewAccessError>

impl ArrowBindingView for u8

Available on crate feature views only.

type Array = PrimitiveArray<UInt8Type>

type View<'a> = u8

fn get_view( array: &Self::Array, index: usize, ) -> Result<Self::View<'_>, ViewAccessError>

impl ArrowBindingView for u16

Available on crate feature views only.

type Array = PrimitiveArray<UInt16Type>

type View<'a> = u16

fn get_view( array: &Self::Array, index: usize, ) -> Result<Self::View<'_>, ViewAccessError>

impl ArrowBindingView for u32

Available on crate feature views only.

type Array = PrimitiveArray<UInt32Type>

type View<'a> = u32

fn get_view( array: &Self::Array, index: usize, ) -> Result<Self::View<'_>, ViewAccessError>

impl ArrowBindingView for u64

Available on crate feature views only.

type Array = PrimitiveArray<UInt64Type>

type View<'a> = u64

fn get_view( array: &Self::Array, index: usize, ) -> Result<Self::View<'_>, ViewAccessError>

impl ArrowBindingView for String

Available on crate feature views only.

type Array = GenericByteArray<GenericStringType<i32>>

type View<'a> = &'a str

fn get_view( array: &Self::Array, index: usize, ) -> Result<Self::View<'_>, ViewAccessError>

impl ArrowBindingView for Vec<u8>

Available on crate feature views only.

type Array = GenericByteArray<GenericBinaryType<i32>>

type View<'a> = &'a [u8]

fn get_view( array: &Self::Array, index: usize, ) -> Result<Self::View<'_>, ViewAccessError>

impl ArrowBindingView for f16

Available on crate feature views only.

type Array = PrimitiveArray<Float16Type>

type View<'a> = f16

fn get_view( array: &Self::Array, index: usize, ) -> Result<Self::View<'_>, ViewAccessError>

impl<T> ArrowBindingView for Option<T>

where T: ArrowBindingView,

Available on crate feature views only.

Implement ArrowBindingView for Option where T implements ArrowBindingView.

This allows nullable fields to properly handle null values by returning Ok(None) instead of Err(UnexpectedNull), making the type system enforce correct null handling.

type Array = <T as ArrowBindingView>::Array

type View<'a> = Option<<T as ArrowBindingView>::View<'a>> where Self: 'a

fn get_view( array: &Self::Array, index: usize, ) -> Result<Self::View<'_>, ViewAccessError>

impl<const N: usize> ArrowBindingView for [u8; N]

Available on crate feature views only.

type Array = FixedSizeBinaryArray

type View<'a> = &'a [u8]

fn get_view( array: &Self::Array, index: usize, ) -> Result<Self::View<'_>, ViewAccessError>

Implementors

impl ArrowBindingView for Date32

Available on crate feature views only.

type Array = PrimitiveArray<Date32Type>

type View<'a> = Date32

impl ArrowBindingView for Date64

Available on crate feature views only.

type Array = PrimitiveArray<Date64Type>

type View<'a> = Date64

impl ArrowBindingView for IntervalDayTime

Available on crate feature views only.

type Array = PrimitiveArray<IntervalDayTimeType>

type View<'a> = IntervalDayTime

impl ArrowBindingView for IntervalMonthDayNano

Available on crate feature views only.

type Array = PrimitiveArray<IntervalMonthDayNanoType>

type View<'a> = IntervalMonthDayNano

impl ArrowBindingView for IntervalYearMonth

Available on crate feature views only.

type Array = PrimitiveArray<IntervalYearMonthType>

type View<'a> = IntervalYearMonth

impl ArrowBindingView for LargeBinary

Available on crate feature views only.

type Array = GenericByteArray<GenericBinaryType<i64>>

type View<'a> = &'a [u8]

impl ArrowBindingView for LargeUtf8

Available on crate feature views only.

type Array = GenericByteArray<GenericStringType<i64>>

type View<'a> = &'a str

impl ArrowBindingView for Null

Available on crate feature views only.

type Array = NullArray

type View<'a> = Null

impl<K, V> ArrowBindingView for Dictionary<K, V>

where K: DictKey + 'static, V: ArrowBinding + ArrowBindingView + 'static, <K as DictKey>::ArrowKey: ArrowDictionaryKeyType,

Available on crate feature views only.

type Array = DictionaryArray<<K as DictKey>::ArrowKey>

type View<'a> = <V as ArrowBindingView>::View<'a> where Self: 'a

impl<K, V> ArrowBindingView for OrderedMap<K, Option<V>>

where K: ArrowBinding + Ord + ArrowBindingView + 'static, V: ArrowBinding + ArrowBindingView + 'static,

Available on crate feature views only.

type Array = MapArray

type View<'a> = MapViewNullable<'a, K, V, true>

impl<K, V> ArrowBindingView for OrderedMap<K, V>

where K: ArrowBinding + Ord + ArrowBindingView + 'static, V: ArrowBinding + ArrowBindingView + 'static,

Available on crate feature views only.

type Array = MapArray

type View<'a> = MapView<'a, K, V, true>

impl<K, V, const SORTED: bool> ArrowBindingView for Map<K, Option<V>, SORTED>

where K: ArrowBinding + ArrowBindingView + 'static, V: ArrowBinding + ArrowBindingView + 'static,

Available on crate feature views only.

type Array = MapArray

type View<'a> = MapViewNullable<'a, K, V, SORTED>

impl<K, V, const SORTED: bool> ArrowBindingView for Map<K, V, SORTED>

where K: ArrowBinding + ArrowBindingView + 'static, V: ArrowBinding + ArrowBindingView + 'static,

Available on crate feature views only.

type Array = MapArray

type View<'a> = MapView<'a, K, V, SORTED>

impl<T> ArrowBindingView for LargeList<Option<T>>

where T: ArrowBinding + ArrowBindingView + 'static,

Available on crate feature views only.

type Array = GenericListArray<i64>

type View<'a> = LargeListViewNullable<'a, T>

impl<T> ArrowBindingView for LargeList<T>

where T: ArrowBinding + ArrowBindingView + 'static,

Available on crate feature views only.

type Array = GenericListArray<i64>

type View<'a> = LargeListView<'a, T>

impl<T> ArrowBindingView for List<Option<T>>

where T: ArrowBinding + ArrowBindingView + 'static,

Available on crate feature views only.

type Array = GenericListArray<i32>

type View<'a> = ListViewNullable<'a, T>

impl<T> ArrowBindingView for List<T>

where T: ArrowBinding + ArrowBindingView + 'static,

Available on crate feature views only.

type Array = GenericListArray<i32>

type View<'a> = ListView<'a, T>

impl<T> ArrowBindingView for T

where T: Record + StructView + 'static,

Available on crate feature views only.

type Array = StructArray

type View<'a> = <T as StructView>::View<'a> where T: 'a

impl<T, const N: usize> ArrowBindingView for FixedSizeList<T, N>

where T: ArrowBinding + ArrowBindingView + 'static,

Available on crate feature views only.

type Array = FixedSizeListArray

type View<'a> = FixedSizeListView<'a, T, N>

impl<T, const N: usize> ArrowBindingView for FixedSizeListNullable<T, N>

where T: ArrowBinding + ArrowBindingView + 'static,

Available on crate feature views only.

type Array = FixedSizeListArray

type View<'a> = FixedSizeListViewNullable<'a, T, N>

impl<U: DurationUnitSpec + 'static> ArrowBindingView for Duration<U>

where U::Arrow: ArrowPrimitiveType<Native = i64>,

Available on crate feature views only.

type Array = PrimitiveArray<<U as DurationUnitSpec>::Arrow>

type View<'a> = Duration<U>

impl<U: Time32UnitSpec + 'static> ArrowBindingView for Time32<U>

where U::Arrow: ArrowPrimitiveType<Native = i32>,

Available on crate feature views only.

type Array = PrimitiveArray<<U as Time32UnitSpec>::Arrow>

type View<'a> = Time32<U>

impl<U: Time64UnitSpec + 'static> ArrowBindingView for Time64<U>

where U::Arrow: ArrowPrimitiveType<Native = i64>,

Available on crate feature views only.

type Array = PrimitiveArray<<U as Time64UnitSpec>::Arrow>

type View<'a> = Time64<U>

impl<U: TimeUnitSpec + 'static> ArrowBindingView for Timestamp<U>

Available on crate feature views only.

type Array = PrimitiveArray<<U as TimeUnitSpec>::Arrow>

type View<'a> = Timestamp<U>

impl<U: TimeUnitSpec + 'static, Z: TimeZoneSpec + 'static> ArrowBindingView for TimestampTz<U, Z>

Available on crate feature views only.

type Array = PrimitiveArray<<U as TimeUnitSpec>::Arrow>

type View<'a> = TimestampTz<U, Z>

impl<const P: u8, const S: i8> ArrowBindingView for Decimal128<P, S>

Available on crate feature views only.

type Array = PrimitiveArray<Decimal128Type>

type View<'a> = Decimal128<P, S>

impl<const P: u8, const S: i8> ArrowBindingView for Decimal256<P, S>

Available on crate feature views only.

type Array = PrimitiveArray<Decimal256Type>

type View<'a> = Decimal256<P, S>