Struct PrimitiveBuilder

pub struct PrimitiveBuilder<T> { /* private fields */ }

Builder for PrimitiveArray.

Implementations

impl<T: NativePType> PrimitiveBuilder<T>

pub fn new(nullability: Nullability) -> Self

pub fn with_capacity(nullability: Nullability, capacity: usize) -> Self

pub fn append_mask(&mut self, mask: Mask)

Append a Mask to the null buffer.

pub fn append_value(&mut self, value: T)

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

pub fn values(&self) -> &[T]

pub fn uninit_range(&mut self, len: usize) -> UninitRange<'_, T>

Create a new handle to the next len uninitialized values in the builder.

All reads/writes through the handle to the values buffer or the validity buffer will operate on indices relative to the start of the range.

Example

use std::mem::MaybeUninit;
use vortex_array::builders::{ArrayBuilder, PrimitiveBuilder};
use vortex_dtype::Nullability;

// Create a new builder.
let mut builder: PrimitiveBuilder<i32> = PrimitiveBuilder::with_capacity(Nullability::NonNullable, 5);

// Populate the values in reverse order.
let mut range = builder.uninit_range(5);
for i in [4, 3, 2, 1, 0] {
    range[i] = MaybeUninit::new(i as i32);
}
range.finish();

let built = builder.finish_into_primitive();

assert_eq!(built.as_slice::<i32>(), &[0i32, 1, 2, 3, 4]);

pub fn finish_into_primitive(&mut self) -> PrimitiveArray

pub fn extend_with_iterator( &mut self, iter: impl IntoIterator<Item = T>, mask: Mask, )

Trait Implementations

impl<T: NativePType> ArrayBuilder for PrimitiveBuilder<T>

fn as_any(&self) -> &dyn Any

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

fn dtype(&self) -> &DType

fn len(&self) -> usize

fn append_zeros(&mut self, n: usize)

Appends n “zero” values to the array.

fn append_nulls(&mut self, n: usize)

Appends n “null” values to the array.

fn extend_from_array(&mut self, array: &dyn Array) -> VortexResult<()>

Extends the array with the provided array, canonicalizing if necessary.

fn ensure_capacity(&mut self, capacity: usize)

Ensure that the builder can hold at least capacity number of items

fn set_validity(&mut self, validity: Mask)

Override builders validity with the one provided

fn finish(&mut self) -> ArrayRef

Constructs an Array from the builder components.

fn is_empty(&self) -> bool

fn append_zero(&mut self)

Append a “zero” value to the array.

fn append_null(&mut self)

Append a “null” value to the array.