Struct arrow::array::builder::FixedSizeListBuilder
source · pub struct FixedSizeListBuilder<T>where
T: ArrayBuilder,{ /* private fields */ }
Expand description
Builder for FixedSizeListArray
use arrow_array::{builder::{Int32Builder, FixedSizeListBuilder}, Array, Int32Array};
let values_builder = Int32Builder::new();
let mut builder = FixedSizeListBuilder::new(values_builder, 3);
// [[0, 1, 2], null, [3, null, 5], [6, 7, null]]
builder.values().append_value(0);
builder.values().append_value(1);
builder.values().append_value(2);
builder.append(true);
builder.values().append_null();
builder.values().append_null();
builder.values().append_null();
builder.append(false);
builder.values().append_value(3);
builder.values().append_null();
builder.values().append_value(5);
builder.append(true);
builder.values().append_value(6);
builder.values().append_value(7);
builder.values().append_null();
builder.append(true);
let list_array = builder.finish();
assert_eq!(
*list_array.value(0),
Int32Array::from(vec![Some(0), Some(1), Some(2)])
);
assert!(list_array.is_null(1));
assert_eq!(
*list_array.value(2),
Int32Array::from(vec![Some(3), None, Some(5)])
);
assert_eq!(
*list_array.value(3),
Int32Array::from(vec![Some(6), Some(7), None])
)
Implementations§
source§impl<T> FixedSizeListBuilder<T>where
T: ArrayBuilder,
impl<T> FixedSizeListBuilder<T>where
T: ArrayBuilder,
sourcepub fn new(values_builder: T, value_length: i32) -> FixedSizeListBuilder<T>
pub fn new(values_builder: T, value_length: i32) -> FixedSizeListBuilder<T>
Creates a new FixedSizeListBuilder
from a given values array builder
value_length
is the number of values within each array
sourcepub fn with_capacity(
values_builder: T,
value_length: i32,
capacity: usize,
) -> FixedSizeListBuilder<T>
pub fn with_capacity( values_builder: T, value_length: i32, capacity: usize, ) -> FixedSizeListBuilder<T>
Creates a new FixedSizeListBuilder
from a given values array builder
value_length
is the number of values within each array
capacity
is the number of items to pre-allocate space for in this builder
source§impl<T> FixedSizeListBuilder<T>where
T: ArrayBuilder + 'static,
impl<T> FixedSizeListBuilder<T>where
T: ArrayBuilder + 'static,
sourcepub fn values(&mut self) -> &mut T
pub fn values(&mut self) -> &mut T
Returns the child array builder as a mutable reference.
This mutable reference can be used to append values into the child array builder,
but you must call append
to delimit each distinct list value.
sourcepub fn value_length(&self) -> i32
pub fn value_length(&self) -> i32
Returns the length of the list
sourcepub fn finish(&mut self) -> FixedSizeListArray
pub fn finish(&mut self) -> FixedSizeListArray
Builds the FixedSizeListBuilder
and reset this builder.
sourcepub fn finish_cloned(&self) -> FixedSizeListArray
pub fn finish_cloned(&self) -> FixedSizeListArray
Builds the FixedSizeListBuilder
without resetting the builder.
Trait Implementations§
source§impl<T> ArrayBuilder for FixedSizeListBuilder<T>where
T: ArrayBuilder + 'static,
impl<T> ArrayBuilder for FixedSizeListBuilder<T>where
T: ArrayBuilder + 'static,
source§fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
Returns the builder as a mutable Any
reference.
source§fn into_box_any(self: Box<FixedSizeListBuilder<T>>) -> Box<dyn Any>
fn into_box_any(self: Box<FixedSizeListBuilder<T>>) -> Box<dyn Any>
Returns the boxed builder as a box of Any
.
source§fn finish_cloned(&self) -> Arc<dyn Array>
fn finish_cloned(&self) -> Arc<dyn Array>
Builds the array without resetting the builder.