Struct FixedSizeListBuilder 

pub struct FixedSizeListBuilder { /* private fields */ }

An ArrayBuilder for creating FixedSizeListArray.

Implementations

impl FixedSizeListBuilder

pub fn with_capacity( element_dtype: Arc<DType>, list_size: u32, nullability: Nullability, capacity: usize, ) -> Self

Creates a new FixedSizeListArray builder.

pub fn append_value(&mut self, value: ListScalar<'_>) -> VortexResult<()>

Adds a value to the FixedSizeListArray that we are building.

Note that a ListScalar can represent both a ListArray scalar and a FixedSizeListArray scalar.

pub fn element_dtype(&self) -> &DType

The DType of the inner elements. Note that this is not the same as the DType of the outer FixedSizeList.

pub fn list_size(&self) -> u32

The size of each fixed-size list.

pub fn nullability(&self) -> Nullability

Trait Implementations

impl ArrayBuilder for FixedSizeListBuilder

fn append_zeros(&mut self, n: usize)

We define the “zero” value of a fixed-size list of size m to be a list of m zero values (where “zero value” is defined by the element DType).

We append n * m of these values to the underlying elements array.

fn append_nulls(&mut self, n: usize)

We define the null value of a fixed-size list of size m to be a list of m placeholder values.

We append n * m placeholder values to the underlying elements array.

The placeholder values depend on the nullability of the element type:

• If elements are nullable, we use null values
• If elements are non-nullable, we use zero values

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

This will increase the capacity if extending with this array would go past the original capacity.

fn as_any(&self) -> &dyn Any

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

fn dtype(&self) -> &DType

fn len(&self) -> usize

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.