Struct FixedSizeBinaryBuilder 

pub struct FixedSizeBinaryBuilder {
    values_builder: Vec<u8>,
    null_buffer_builder: NullBufferBuilder,
    value_length: i32,
}

Builder for FixedSizeBinaryArray

let mut builder = FixedSizeBinaryBuilder::with_capacity(3, 5);
// [b"hello", null, b"arrow"]
builder.append_value(b"hello").unwrap();
builder.append_null();
builder.append_value(b"arrow").unwrap();

let array = builder.finish();
assert_eq!(array.value(0), b"hello");
assert!(array.is_null(1));
assert_eq!(array.value(2), b"arrow");

Fields

values_builder: Vec<u8>

null_buffer_builder: NullBufferBuilder

value_length: i32

Implementations

impl FixedSizeBinaryBuilder

pub fn new(byte_width: i32) -> Self

Creates a new FixedSizeBinaryBuilder

pub fn with_capacity(capacity: usize, byte_width: i32) -> Self

Creates a new FixedSizeBinaryBuilder, capacity is the number of byte slices that can be appended without reallocating

Panics

Panics if byte_width < 0

pub fn append_value( &mut self, value: impl AsRef<[u8]>, ) -> Result<(), ArrowError>

Appends a byte slice into the builder.

Automatically update the null buffer to delimit the slice appended in as a distinct value element.

pub fn append_null(&mut self)

Append a null value to the array.

pub fn append_nulls(&mut self, n: usize)

Appends n nulls into the builder.

pub fn append_array( &mut self, array: &FixedSizeBinaryArray, ) -> Result<(), ArrowError>

Appends all elements in array into the builder.

pub fn values_slice(&self) -> &[u8]

Returns the current values buffer as a slice

pub fn finish(&mut self) -> FixedSizeBinaryArray

Builds the FixedSizeBinaryArray and reset this builder.

pub fn finish_cloned(&self) -> FixedSizeBinaryArray

Builds the FixedSizeBinaryArray without resetting the builder.

pub fn validity_slice(&self) -> Option<&[u8]>

Returns the current null buffer as a slice

Trait Implementations

impl ArrayBuilder for FixedSizeBinaryBuilder

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

fn finish_preserve_values(&mut self) -> ArrayRef

Builds the array without resetting the values builder.

impl Debug for FixedSizeBinaryBuilder

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

Formats the value using the given formatter.