Struct arrow_data::transform::MutableArrayData

pub struct MutableArrayData<'a> { /* private fields */ }

Struct to efficiently and interactively create an ArrayData from an existing ArrayData by copying chunks.

The main use case of this struct is to perform unary operations to arrays of arbitrary types, such as filter and take.

Implementations

impl<'a> MutableArrayData<'a>

pub fn new(arrays: Vec<&'a ArrayData>, use_nulls: bool, capacity: usize) -> Self

returns a new MutableArrayData with capacity to capacity slots and specialized to create an ArrayData from multiple arrays.

use_nulls is a flag used to optimize insertions. It should be false if the only source of nulls are the arrays themselves and true if the user plans to call MutableArrayData::extend_nulls. In other words, if use_nulls is false, calling MutableArrayData::extend_nulls should not be used.

pub fn with_capacities( arrays: Vec<&'a ArrayData>, use_nulls: bool, capacities: Capacities, ) -> Self

Similar to MutableArrayData::new, but lets users define the preallocated capacities of the array. See also MutableArrayData::new for more information on the arguments.

Panic

This function panics if the given capacities don’t match the data type of arrays. Or when a Capacities variant is not yet supported.

pub fn extend(&mut self, index: usize, start: usize, end: usize)

Extends this array with a chunk of its source arrays

Arguments

• index - the index of array that you what to copy values from
• start - the start index of the chunk (inclusive)
• end - the end index of the chunk (exclusive)

Panic

This function panics if there is an invalid index, i.e. index >= the number of source arrays or end > the length of the indexth array

pub fn extend_nulls(&mut self, len: usize)

Extends this MutableArrayData with null elements, disregarding the bound arrays

Panics

Panics if MutableArrayData not created with use_nulls or nullable source arrays

pub fn len(&self) -> usize

Returns the current length

pub fn is_empty(&self) -> bool

Returns true if len is 0

pub fn null_count(&self) -> usize

Returns the current null count

pub fn freeze(self) -> ArrayData

Creates a ArrayData from the pushed regions up to this point, consuming self.

pub fn into_builder(self) -> ArrayDataBuilder

Creates a ArrayDataBuilder from the pushed regions up to this point, consuming self. This is useful for extending the default behavior of MutableArrayData.

Trait Implementations

impl<'a> Debug for MutableArrayData<'a>

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

Formats the value using the given formatter.