Struct GenericListViewBuilder

pub struct GenericListViewBuilder<OffsetSize: OffsetSizeTrait, T: ArrayBuilder> { /* private fields */ }

Builder for GenericListViewArray

Implementations

impl<OffsetSize: OffsetSizeTrait, T: ArrayBuilder> GenericListViewBuilder<OffsetSize, T>

pub fn new(values_builder: T) -> Self

Creates a new GenericListViewBuilder from a given values array builder

pub fn with_capacity(values_builder: T, capacity: usize) -> Self

Creates a new GenericListViewBuilder from a given values array builder capacity is the number of items to pre-allocate space for in this builder

pub fn with_field(self, field: impl Into<FieldRef>) -> Self

By default a nullable field is created with the name item

Note: Self::finish and Self::finish_cloned will panic if the field’s data type does not match that of T

impl<OffsetSize: OffsetSizeTrait, T> GenericListViewBuilder<OffsetSize, T>

where T: 'static + ArrayBuilder,

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.

pub fn values_ref(&self) -> &T

Returns the child array builder as an immutable reference

pub fn append(&mut self, is_valid: bool)

Finish the current variable-length list array slot

Panics

Panics if the length of Self::values exceeds OffsetSize::MAX

pub fn append_value<I, V>(&mut self, i: I)

where T: Extend<Option<V>>, I: IntoIterator<Item = Option<V>>,

Append value into this GenericListViewBuilder

pub fn append_null(&mut self)

Append a null to this GenericListViewBuilder

See Self::append_value for an example use.

pub fn append_option<I, V>(&mut self, i: Option<I>)

where T: Extend<Option<V>>, I: IntoIterator<Item = Option<V>>,

Appends an optional value into this GenericListViewBuilder

If Some calls Self::append_value otherwise calls Self::append_null

pub fn finish(&mut self) -> GenericListViewArray<OffsetSize>

Builds the GenericListViewArray and reset this builder.

pub fn finish_cloned(&self) -> GenericListViewArray<OffsetSize>

Builds the GenericListViewArray without resetting the builder.

pub fn offsets_slice(&self) -> &[OffsetSize]

Returns the current offsets buffer as a slice

Trait Implementations

impl<OffsetSize: OffsetSizeTrait, T: ArrayBuilder> ArrayBuilder for GenericListViewBuilder<OffsetSize, T>

fn as_any(&self) -> &dyn Any

Returns the builder as a non-mutable Any reference.

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

Returns the builder as a mutable Any reference.

fn into_box_any(self: Box<Self>) -> Box<dyn Any>

Returns the boxed builder as a box of Any.

fn len(&self) -> usize

Returns the number of array slots in the builder

fn finish(&mut self) -> ArrayRef

Builds the array and reset this builder.

fn finish_cloned(&self) -> ArrayRef

Builds the array without resetting the builder.

fn is_empty(&self) -> bool

Returns whether number of array slots is zero

impl<OffsetSize: Debug + OffsetSizeTrait, T: Debug + ArrayBuilder> Debug for GenericListViewBuilder<OffsetSize, T>

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

Formats the value using the given formatter.

impl<O: OffsetSizeTrait, T: ArrayBuilder + Default> Default for GenericListViewBuilder<O, T>

fn default() -> Self

Returns the “default value” for a type.

impl<O, B, V, E> Extend<Option<V>> for GenericListViewBuilder<O, B>

where O: OffsetSizeTrait, B: ArrayBuilder + Extend<E>, V: IntoIterator<Item = E>,

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

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.