arrow_array::builder

Struct BufferBuilder

Source
pub struct BufferBuilder<T>
where T: ArrowNativeType,
{ /* private fields */ }
Expand description

Builder for creating a Buffer object.

A Buffer is the underlying data structure of Arrow’s Arrays.

For all supported types, there are type definitions for the generic version of BufferBuilder<T>, e.g. BufferBuilder.

§Example:


let mut builder = BufferBuilder::<u8>::new(100);
builder.append_slice(&[42, 43, 44]);
builder.append(45);
let buffer = builder.finish();

assert_eq!(unsafe { buffer.typed_data::<u8>() }, &[42, 43, 44, 45]);

Implementations§

Source§

impl<T> BufferBuilder<T>
where T: ArrowNativeType,

Source

pub fn new(capacity: usize) -> BufferBuilder<T>

Creates a new builder with initial capacity for at least capacity elements of type T.

The capacity can later be manually adjusted with the reserve() method. Also the append(), append_slice() and advance() methods automatically increase the capacity if needed.

§Example:

let mut builder = BufferBuilder::<u8>::new(10);

assert!(builder.capacity() >= 10);
Source

pub fn new_from_buffer(buffer: MutableBuffer) -> BufferBuilder<T>

Creates a new builder from a MutableBuffer

Source

pub fn len(&self) -> usize

Returns the current number of array elements in the internal buffer.

§Example:

let mut builder = BufferBuilder::<u8>::new(10);
builder.append(42);

assert_eq!(builder.len(), 1);
Source

pub fn is_empty(&self) -> bool

Returns whether the internal buffer is empty.

§Example:

let mut builder = BufferBuilder::<u8>::new(10);
builder.append(42);

assert_eq!(builder.is_empty(), false);
Source

pub fn capacity(&self) -> usize

Returns the actual capacity (number of elements) of the internal buffer.

Note: the internal capacity returned by this method might be larger than what you’d expect after setting the capacity in the new() or reserve() functions.

Source

pub fn advance(&mut self, i: usize)

Increases the number of elements in the internal buffer by n and resizes the buffer as needed.

The values of the newly added elements are 0. This method is usually used when appending NULL values to the buffer as they still require physical memory space.

§Example:

let mut builder = BufferBuilder::<u8>::new(10);
builder.advance(2);

assert_eq!(builder.len(), 2);
Source

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

Reserves memory for at least n more elements of type T.

§Example:

let mut builder = BufferBuilder::<u8>::new(10);
builder.reserve(10);

assert!(builder.capacity() >= 20);
Source

pub fn append(&mut self, v: T)

Appends a value of type T into the builder, growing the internal buffer as needed.

§Example:

let mut builder = BufferBuilder::<u8>::new(10);
builder.append(42);

assert_eq!(builder.len(), 1);
Source

pub fn append_n(&mut self, n: usize, v: T)

Appends a value of type T into the builder N times, growing the internal buffer as needed.

§Example:

let mut builder = BufferBuilder::<u8>::new(10);
builder.append_n(10, 42);

assert_eq!(builder.len(), 10);
Source

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

Appends n, zero-initialized values

§Example:

let mut builder = BufferBuilder::<u32>::new(10);
builder.append_n_zeroed(3);

assert_eq!(builder.len(), 3);
assert_eq!(builder.as_slice(), &[0, 0, 0])
Source

pub fn append_slice(&mut self, slice: &[T])

Appends a slice of type T, growing the internal buffer as needed.

§Example:

let mut builder = BufferBuilder::<u8>::new(10);
builder.append_slice(&[42, 44, 46]);

assert_eq!(builder.len(), 3);
Source

pub fn as_slice(&self) -> &[T]

View the contents of this buffer as a slice


let mut builder = BufferBuilder::<f64>::new(10);
builder.append(1.3);
builder.append_n(2, 2.3);

assert_eq!(builder.as_slice(), &[1.3, 2.3, 2.3]);
Source

pub fn as_slice_mut(&mut self) -> &mut [T]

View the contents of this buffer as a mutable slice

§Example:

let mut builder = BufferBuilder::<f32>::new(10);

builder.append_slice(&[1., 2., 3.4]);
assert_eq!(builder.as_slice(), &[1., 2., 3.4]);

builder.as_slice_mut()[1] = 4.2;
assert_eq!(builder.as_slice(), &[1., 4.2, 3.4]);
Source

pub fn truncate(&mut self, len: usize)

Shorten this BufferBuilder to len items

If len is greater than the builder’s current length, this has no effect

§Example:

let mut builder = BufferBuilder::<u16>::new(10);

builder.append_slice(&[42, 44, 46]);
assert_eq!(builder.as_slice(), &[42, 44, 46]);

builder.truncate(2);
assert_eq!(builder.as_slice(), &[42, 44]);

builder.append(12);
assert_eq!(builder.as_slice(), &[42, 44, 12]);
Source

pub unsafe fn append_trusted_len_iter( &mut self, iter: impl IntoIterator<Item = T>, )

§Safety

This requires the iterator be a trusted length. This could instead require the iterator implement TrustedLen once that is stabilized.

Source

pub fn finish(&mut self) -> Buffer

Resets this builder and returns an immutable Buffer.

§Example:

let mut builder = BufferBuilder::<u8>::new(10);
builder.append_slice(&[42, 44, 46]);

let buffer = builder.finish();

assert_eq!(unsafe { buffer.typed_data::<u8>() }, &[42, 44, 46]);

Trait Implementations§

Source§

impl<T> Debug for BufferBuilder<T>

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<T> Default for BufferBuilder<T>
where T: ArrowNativeType,

Source§

fn default() -> BufferBuilder<T>

Returns the “default value” for a type. Read more
Source§

impl<T> Extend<T> for BufferBuilder<T>
where T: ArrowNativeType,

Source§

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

Extends a collection with the contents of an iterator. Read more
Source§

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)

🔬This is a nightly-only experimental API. (extend_one)
Reserves capacity in a collection for the given number of additional elements. Read more
Source§

impl<T> From<Vec<T>> for BufferBuilder<T>
where T: ArrowNativeType,

Source§

fn from(value: Vec<T>) -> BufferBuilder<T>

Converts to this type from the input type.
Source§

impl<T> FromIterator<T> for BufferBuilder<T>
where T: ArrowNativeType,

Source§

fn from_iter<I>(iter: I) -> BufferBuilder<T>
where I: IntoIterator<Item = T>,

Creates a value from an iterator. Read more

Auto Trait Implementations§

§

impl<T> Freeze for BufferBuilder<T>

§

impl<T> RefUnwindSafe for BufferBuilder<T>
where T: RefUnwindSafe,

§

impl<T> Send for BufferBuilder<T>

§

impl<T> Sync for BufferBuilder<T>

§

impl<T> Unpin for BufferBuilder<T>
where T: Unpin,

§

impl<T> UnwindSafe for BufferBuilder<T>
where T: UnwindSafe,

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> Allocation for T
where T: RefUnwindSafe + Send + Sync,