Struct List 

pub struct List<T>(/* private fields */);

Wrapper denoting an Arrow ListArray column with elements of T.

Notes:

• List-level nullability: wrap the column in Option<List<T>>.
• Item-level nullability: use List<Option<T>> when elements can be null.

Implementations

impl<T> List<T>

pub fn new(values: Vec<T>) -> Self

Construct a new list from a vector of values.

pub fn values(&self) -> &Vec<T>

Borrow the underlying values.

pub fn into_inner(self) -> Vec<T>

Consume and return the underlying vector of values.

Trait Implementations

impl<T> ArrowBinding for List<Option<T>>

where T: ArrowBinding, <T as ArrowBinding>::Builder: ArrayBuilder,

Provide ArrowBinding for List<Option<T>> so users can express item-nullability via Option in the type parameter.

type Builder = GenericListBuilder<i32, <T as ArrowBinding>::Builder>

Concrete Arrow builder type used for this Rust type.

type Array = GenericListArray<i32>

Concrete Arrow array type produced by finish.

fn data_type() -> DataType

The Arrow DataType corresponding to this Rust type.

fn new_builder(_capacity: usize) -> Self::Builder

Create a new builder with an optional capacity hint.

fn append_value(b: &mut Self::Builder, v: &Self)

Append a non-null value to the builder.

fn append_null(b: &mut Self::Builder)

Append a null to the builder.

fn finish(b: Self::Builder) -> Self::Array

Finish the builder and produce a typed Arrow array.

fn estimated_bytes_per_value() -> usize

Estimated bytes per value for variable-length types (String, Binary, etc.). Returns 0 for fixed-size types. Used to pre-allocate buffer space.

impl<T> ArrowBinding for List<T>

where T: ArrowBinding, <T as ArrowBinding>::Builder: ArrayBuilder,

type Builder = GenericListBuilder<i32, <T as ArrowBinding>::Builder>

Concrete Arrow builder type used for this Rust type.

type Array = GenericListArray<i32>

Concrete Arrow array type produced by finish.

fn data_type() -> DataType

The Arrow DataType corresponding to this Rust type.

fn new_builder(_capacity: usize) -> Self::Builder

Create a new builder with an optional capacity hint.

fn append_value(b: &mut Self::Builder, v: &Self)

Append a non-null value to the builder.

fn append_null(b: &mut Self::Builder)

Append a null to the builder.

fn finish(b: Self::Builder) -> Self::Array

Finish the builder and produce a typed Arrow array.

fn estimated_bytes_per_value() -> usize

Estimated bytes per value for variable-length types (String, Binary, etc.). Returns 0 for fixed-size types. Used to pre-allocate buffer space.

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

where T: ArrowBinding + ArrowBindingView + 'static,

Available on crate feature views only.

type Array = GenericListArray<i32>

The Arrow array type this view reads from.

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

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

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

Extract a view at the given index from the array.

impl<T> ArrowBindingView for List<T>

where T: ArrowBinding + ArrowBindingView + 'static,

Available on crate feature views only.

type Array = GenericListArray<i32>

The Arrow array type this view reads from.

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

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

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

Extract a view at the given index from the array.

impl<T: Clone> Clone for List<T>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for List<T>

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

Formats the value using the given formatter.

impl<T> From<Vec<T>> for List<T>

fn from(values: Vec<T>) -> Self

Convert a vector into a List<T>.

impl<T> FromIterator<T> for List<T>

fn from_iter<I: IntoIterator<Item = T>>(iter: I) -> Self

Collect an iterator into a List<T>.