Struct arrow2::array::MutablePrimitiveArray

pub struct MutablePrimitiveArray<T: NativeType> { /* fields omitted */ }

The mutable version of PrimitiveArray. See MutableArray for more details.

Implementations

impl<T: NativeType + NaturalDataType> MutablePrimitiveArray<T>

pub fn new() -> Self

Creates a new empty MutablePrimitiveArray.

pub fn with_capacity(capacity: usize) -> Self

Creates a new MutablePrimitiveArray with a capacity.

pub fn from_data(
    data_type: DataType,
    values: MutableBuffer<T>,
    validity: Option<MutableBitmap>
) -> Self

Create a MutablePrimitiveArray out of low-end APIs.

Panics

This function panics iff:

• data_type is not supported by the physical type
• The validity is not None and its length is different from the values’s length

pub fn into_data(self) -> (DataType, MutableBuffer<T>, Option<MutableBitmap>)

Extract the low-end APIs from the MutablePrimitiveArray.

impl<T: NativeType> MutablePrimitiveArray<T>

pub fn with_capacity_from(capacity: usize, data_type: DataType) -> Self

Creates a new MutablePrimitiveArray from a capacity and DataType.

pub fn reserve(&mut self, additional: usize)

Reserves additional entries.

pub fn push(&mut self, value: Option<T>)

Adds a new value to the array.

pub fn extend_trusted_len<P, I>(&mut self, iterator: I) where
    P: Borrow<T>,
    I: TrustedLen<Item = Option<P>>, 

Extends the MutablePrimitiveArray from an iterator of trusted len.

pub unsafe fn extend_trusted_len_unchecked<P, I>(&mut self, iterator: I) where
    P: Borrow<T>,
    I: Iterator<Item = Option<P>>, 

Extends the MutablePrimitiveArray from an iterator of trusted len.

Safety

The iterator must be trusted len.

pub fn to(self, data_type: DataType) -> Self

Changes the arrays’ DataType, returning a new MutablePrimitiveArray. Use to change the logical type without changing the corresponding physical Type.

Implementation

This operation is O(1).

pub fn into_arc(self) -> Arc<dyn Array>

Converts itself into an Array.

impl<T: NativeType> MutablePrimitiveArray<T>

Accessors

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

Returns its values.

pub fn values_mut_slice(&mut self) -> &mut [T]

Returns a mutable slice of values.

impl<T: NativeType> MutablePrimitiveArray<T>

Setters

pub fn set(&mut self, index: usize, value: Option<T>)

Sets position index to value. Note that if it is the first time a null appears in this array, this initializes the validity bitmap (O(N)).

Panic

Panics iff index is larger than self.len().

pub fn set_validity(&mut self, validity: Option<MutableBitmap>)

Sets the validity.

Panic

Panics iff the validity’s len is not equal to the existing values’ length.

pub fn set_values(&mut self, values: MutableBuffer<T>)

Sets values.

Panic

Panics iff the values’ length is not equal to the existing validity’s len.

impl<T: NativeType + NaturalDataType> MutablePrimitiveArray<T>

pub fn from_slice<P: AsRef<[T]>>(slice: P) -> Self

Creates a MutablePrimitiveArray from a slice of values.

pub unsafe fn from_trusted_len_iter_unchecked<I, P>(iterator: I) -> Self where
    P: Borrow<T>,
    I: Iterator<Item = Option<P>>, 

Creates a MutablePrimitiveArray from an iterator of trusted length.

Safety

The iterator must be TrustedLen. I.e. size_hint().1 correctly reports its length.

pub fn from_trusted_len_iter<I, P>(iterator: I) -> Self where
    P: Borrow<T>,
    I: TrustedLen<Item = Option<P>>, 

Creates a MutablePrimitiveArray from a TrustedLen.

pub unsafe fn try_from_trusted_len_iter_unchecked<E, I, P>(
    iter: I
) -> Result<Self, E> where
    P: Borrow<T>,
    I: IntoIterator<Item = Result<Option<P>, E>>, 

Creates a MutablePrimitiveArray from an fallible iterator of trusted length.

Safety

The iterator must be TrustedLen. I.e. that size_hint().1 correctly reports its length.

pub fn try_from_trusted_len_iter<E, I, P>(iterator: I) -> Result<Self, E> where
    P: Borrow<T>,
    I: TrustedLen<Item = Result<Option<P>, E>>, 

Creates a MutablePrimitiveArray from an fallible iterator of trusted length.

pub fn from_trusted_len_values_iter<I: TrustedLen<Item = T>>(iter: I) -> Self

Creates a new MutablePrimitiveArray out an iterator over values

pub unsafe fn from_trusted_len_values_iter_unchecked<I: Iterator<Item = T>>(
    iter: I
) -> Self

Creates a new MutablePrimitiveArray from an iterator over values

Safety

The iterator must be TrustedLen. I.e. that size_hint().1 correctly reports its length.

Trait Implementations

impl<T: Debug + NativeType> Debug for MutablePrimitiveArray<T>

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

Formats the value using the given formatter.

impl<T: NativeType + NaturalDataType> Default for MutablePrimitiveArray<T>

fn default() -> Self

Returns the “default value” for a type.

impl<T: NativeType> Extend<Option<T>> for MutablePrimitiveArray<T>

fn extend<I: IntoIterator<Item = Option<T>>>(&mut self, iter: I)

Extends a collection with the contents of an iterator.

fn extend_one(&mut self, item: A)

🔬 This is a nightly-only experimental API. (extend_one)

Extends a collection with exactly one element.

fn extend_reserve(&mut self, additional: usize)

🔬 This is a nightly-only experimental API. (extend_one)

Reserves capacity in a collection for the given number of additional elements.

impl<T: NativeType> From<DataType> for MutablePrimitiveArray<T>

fn from(data_type: DataType) -> Self

Performs the conversion.

impl<T: NativeType> From<MutablePrimitiveArray<T>> for PrimitiveArray<T>

fn from(other: MutablePrimitiveArray<T>) -> Self

Performs the conversion.

impl<T: NativeType + NaturalDataType, P: AsRef<[Option<T>]>> From<P> for MutablePrimitiveArray<T>

fn from(slice: P) -> Self

Performs the conversion.

impl<T: NativeType + NaturalDataType, Ptr: Borrow<Option<T>>> FromIterator<Ptr> for MutablePrimitiveArray<T>

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

Creates a value from an iterator.

impl<T: NativeType> MutableArray for MutablePrimitiveArray<T>

fn len(&self) -> usize

The length of the array.

fn validity(&self) -> &Option<MutableBitmap>

The optional validity of the array.

fn as_arc(&mut self) -> Arc<dyn Array>

Convert itself to an (immutable) Array.

fn data_type(&self) -> &DataType

The DataType of the array.

fn as_any(&self) -> &dyn Any

Convert to Any, to enable dynamic casting.

fn as_mut_any(&mut self) -> &mut dyn Any

Convert to mutable Any, to enable dynamic casting.

fn push_null(&mut self)

Adds a new null element to the array.

fn is_empty(&self) -> bool

Whether the array is empty.

fn is_valid(&self, index: usize) -> bool

Whether index is valid / set.

impl<T: NativeType> TryExtend<Option<T>> for MutablePrimitiveArray<T>

fn try_extend<I: IntoIterator<Item = Option<T>>>(
    &mut self,
    iter: I
) -> Result<()>

This is infalible and is implemented for consistency with all other types