Struct Map 

pub struct Map<K, V, const SORTED: bool = false>(/* private fields */);

Wrapper denoting an Arrow MapArray column with entries (K, V).

• Keys are non-nullable by Arrow spec.
• Values are non-nullable for Map<K, V, SORTED> and nullable for Map<K, Option<V>, SORTED>.
• Column-level nullability is expressed with Option<Map<...>>.

Implementations

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

pub fn new(entries: Vec<(K, V)>) -> Self

Construct a new map from a vector of (key, value) pairs.

pub fn entries(&self) -> &Vec<(K, V)>

Borrow the underlying (key, value) entries.

pub fn into_inner(self) -> Vec<(K, V)>

Consume and return the underlying (key, value) entries.

Trait Implementations

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

where K: ArrowBinding, V: ArrowBinding, <K as ArrowBinding>::Builder: ArrayBuilder, <V as ArrowBinding>::Builder: ArrayBuilder,

type Builder = MapBuilder<<K as ArrowBinding>::Builder, <V as ArrowBinding>::Builder>

Concrete Arrow builder type used for this Rust type.

type Array = MapArray

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<K, V, const SORTED: bool> ArrowBinding for Map<K, V, SORTED>

where K: ArrowBinding, V: ArrowBinding, <K as ArrowBinding>::Builder: ArrayBuilder, <V as ArrowBinding>::Builder: ArrayBuilder,

type Builder = MapBuilder<<K as ArrowBinding>::Builder, <V as ArrowBinding>::Builder>

Concrete Arrow builder type used for this Rust type.

type Array = MapArray

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<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

The Arrow array type this view reads from.

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

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<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

The Arrow array type this view reads from.

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

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<K: Clone, V: Clone, const SORTED: bool> Clone for Map<K, V, SORTED>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

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

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

Formats the value using the given formatter.

impl<K, V, const SORTED: bool> From<Vec<(K, V)>> for Map<K, V, SORTED>

fn from(entries: Vec<(K, V)>) -> Self

Convert a vector of (key, value) pairs into a Map.

impl<K, V, const SORTED: bool> FromIterator<(K, V)> for Map<K, V, SORTED>

fn from_iter<I: IntoIterator<Item = (K, V)>>(iter: I) -> Self

Collect an iterator of (key, value) pairs into a Map.