Struct arrow::array::BufferBuilder [−][src]
pub struct BufferBuilder<T: ArrowNativeType> { /* fields omitted */ }
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. UInt8BufferBuilder
.
Example:
use arrow::array::UInt8BufferBuilder; let mut builder = UInt8BufferBuilder::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
impl<T: ArrowNativeType> BufferBuilder<T>
[src]
impl<T: ArrowNativeType> BufferBuilder<T>
[src]pub fn new(capacity: usize) -> Self
[src]
pub fn new(capacity: usize) -> Self
[src]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:
use arrow::array::UInt8BufferBuilder; let mut builder = UInt8BufferBuilder::new(10); assert!(builder.capacity() >= 10);
pub fn len(&self) -> usize
[src]
pub fn len(&self) -> usize
[src]Returns the current number of array elements in the internal buffer.
Example:
use arrow::array::UInt8BufferBuilder; let mut builder = UInt8BufferBuilder::new(10); builder.append(42); assert_eq!(builder.len(), 1);
pub fn is_empty(&self) -> bool
[src]
pub fn is_empty(&self) -> bool
[src]Returns whether the internal buffer is empty.
Example:
use arrow::array::UInt8BufferBuilder; let mut builder = UInt8BufferBuilder::new(10); builder.append(42); assert_eq!(builder.is_empty(), false);
pub fn capacity(&self) -> usize
[src]
pub fn capacity(&self) -> usize
[src]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.
pub fn advance(&mut self, i: usize)
[src]
pub fn advance(&mut self, i: usize)
[src]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:
use arrow::array::UInt8BufferBuilder; let mut builder = UInt8BufferBuilder::new(10); builder.advance(2); assert_eq!(builder.len(), 2);
pub fn reserve(&mut self, n: usize)
[src]
pub fn reserve(&mut self, n: usize)
[src]Reserves memory for at least n
more elements of type T
.
Example:
use arrow::array::UInt8BufferBuilder; let mut builder = UInt8BufferBuilder::new(10); builder.reserve(10); assert!(builder.capacity() >= 20);
pub fn append(&mut self, v: T)
[src]
pub fn append(&mut self, v: T)
[src]Appends a value of type T
into the builder,
growing the internal buffer as needed.
Example:
use arrow::array::UInt8BufferBuilder; let mut builder = UInt8BufferBuilder::new(10); builder.append(42); assert_eq!(builder.len(), 1);
pub fn append_n(&mut self, n: usize, v: T)
[src]
pub fn append_n(&mut self, n: usize, v: T)
[src]Appends a value of type T
into the builder N times,
growing the internal buffer as needed.
Example:
use arrow::array::UInt8BufferBuilder; let mut builder = UInt8BufferBuilder::new(10); builder.append_n(10, 42); assert_eq!(builder.len(), 10);
pub fn append_slice(&mut self, slice: &[T])
[src]
pub fn append_slice(&mut self, slice: &[T])
[src]Appends a slice of type T
, growing the internal buffer as needed.
Example:
use arrow::array::UInt8BufferBuilder; let mut builder = UInt8BufferBuilder::new(10); builder.append_slice(&[42, 44, 46]); assert_eq!(builder.len(), 3);
Trait Implementations
impl<T: Debug + ArrowNativeType> Debug for BufferBuilder<T>
[src]
impl<T: Debug + ArrowNativeType> Debug for BufferBuilder<T>
[src]Auto Trait Implementations
impl<T> RefUnwindSafe for BufferBuilder<T> where
T: RefUnwindSafe,
T: RefUnwindSafe,
impl<T> Send for BufferBuilder<T>
impl<T> Sync for BufferBuilder<T>
impl<T> Unpin for BufferBuilder<T> where
T: Unpin,
T: Unpin,
impl<T> UnwindSafe for BufferBuilder<T> where
T: UnwindSafe,
T: UnwindSafe,
Blanket Implementations
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]pub fn borrow_mut(&mut self) -> &mut T
[src]
pub fn borrow_mut(&mut self) -> &mut T
[src]Mutably borrows from an owned value. Read more
impl<V, T> VZip<V> for T where
V: MultiLane<T>,
impl<V, T> VZip<V> for T where
V: MultiLane<T>,