Struct arrow_array::builder::GenericByteRunBuilder
source · pub struct GenericByteRunBuilder<R, V>where
R: ArrowPrimitiveType,
V: ByteArrayType,{ /* private fields */ }
Expand description
Builder for RunArray
of GenericByteArray
§Example:
let mut builder =
GenericByteRunBuilder::<Int16Type, BinaryType>::new();
builder.extend([Some(b"abc"), Some(b"abc"), None, Some(b"def")].into_iter());
builder.append_value(b"def");
builder.append_null();
let array = builder.finish();
assert_eq!(array.run_ends().values(), &[2, 3, 5, 6]);
let av = array.values();
assert!(!av.is_null(0));
assert!(av.is_null(1));
assert!(!av.is_null(2));
assert!(av.is_null(3));
// Values are polymorphic and so require a downcast.
let ava: &BinaryArray = av.as_binary();
assert_eq!(ava.value(0), b"abc");
assert_eq!(ava.value(2), b"def");
Implementations§
source§impl<R, V> GenericByteRunBuilder<R, V>where
R: ArrowPrimitiveType,
V: ByteArrayType,
impl<R, V> GenericByteRunBuilder<R, V>where
R: ArrowPrimitiveType,
V: ByteArrayType,
sourcepub fn with_capacity(capacity: usize, data_capacity: usize) -> Self
pub fn with_capacity(capacity: usize, data_capacity: usize) -> Self
Creates a new GenericByteRunBuilder
with the provided capacity
capacity
: the expected number of run-end encoded values.
data_capacity
: the expected number of bytes of run end encoded values
source§impl<R, V> GenericByteRunBuilder<R, V>where
R: RunEndIndexType,
V: ByteArrayType,
impl<R, V> GenericByteRunBuilder<R, V>where
R: RunEndIndexType,
V: ByteArrayType,
sourcepub fn append_option(&mut self, input_value: Option<impl AsRef<V::Native>>)
pub fn append_option(&mut self, input_value: Option<impl AsRef<V::Native>>)
Appends optional value to the logical array encoded by the RunArray.
sourcepub fn append_value(&mut self, input_value: impl AsRef<V::Native>)
pub fn append_value(&mut self, input_value: impl AsRef<V::Native>)
Appends value to the logical array encoded by the RunArray.
sourcepub fn append_null(&mut self)
pub fn append_null(&mut self)
Appends null to the logical array encoded by the RunArray.
sourcepub fn finish(&mut self) -> RunArray<R>
pub fn finish(&mut self) -> RunArray<R>
Creates the RunArray and resets the builder. Panics if RunArray cannot be built.
sourcepub fn finish_cloned(&self) -> RunArray<R>
pub fn finish_cloned(&self) -> RunArray<R>
Creates the RunArray and without resetting the builder. Panics if RunArray cannot be built.
Trait Implementations§
source§impl<R, V> ArrayBuilder for GenericByteRunBuilder<R, V>where
R: RunEndIndexType,
V: ByteArrayType,
impl<R, V> ArrayBuilder for GenericByteRunBuilder<R, V>where
R: RunEndIndexType,
V: ByteArrayType,
source§impl<R, V> Debug for GenericByteRunBuilder<R, V>
impl<R, V> Debug for GenericByteRunBuilder<R, V>
source§impl<R, V> Default for GenericByteRunBuilder<R, V>where
R: ArrowPrimitiveType,
V: ByteArrayType,
impl<R, V> Default for GenericByteRunBuilder<R, V>where
R: ArrowPrimitiveType,
V: ByteArrayType,
source§impl<R, V, S> Extend<Option<S>> for GenericByteRunBuilder<R, V>
impl<R, V, S> Extend<Option<S>> for GenericByteRunBuilder<R, V>
source§fn extend<T: IntoIterator<Item = Option<S>>>(&mut self, iter: T)
fn extend<T: IntoIterator<Item = Option<S>>>(&mut self, iter: T)
Extends a collection with the contents of an iterator. Read more
source§fn extend_one(&mut self, item: A)
fn extend_one(&mut self, item: A)
🔬This is a nightly-only experimental API. (
extend_one
)Extends a collection with exactly one element.
source§fn extend_reserve(&mut self, additional: usize)
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. Read more
Auto Trait Implementations§
impl<R, V> Freeze for GenericByteRunBuilder<R, V>
impl<R, V> RefUnwindSafe for GenericByteRunBuilder<R, V>where
<R as ArrowPrimitiveType>::Native: RefUnwindSafe,
<V as ByteArrayType>::Offset: RefUnwindSafe,
impl<R, V> Send for GenericByteRunBuilder<R, V>
impl<R, V> Sync for GenericByteRunBuilder<R, V>
impl<R, V> Unpin for GenericByteRunBuilder<R, V>
impl<R, V> UnwindSafe for GenericByteRunBuilder<R, V>
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more