Struct BytesTape

pub struct BytesTape<Offset: OffsetType = i32, A: Allocator = Global> { /* private fields */ }

Binary bytes view over RawTape.

Implementations

impl<Offset: OffsetType, A: Allocator> BytesTape<Offset, A>

pub fn new() -> BytesTape<Offset, Global>

Creates a new, empty BytesTape with the global allocator.

pub fn new_in(allocator: A) -> Self

Creates a new, empty BytesTape with a custom allocator.

pub fn with_capacity( data_capacity: usize, items_capacity: usize, ) -> Result<BytesTape<Offset, Global>, StringTapeError>

Creates a new BytesTape with pre-allocated capacity using the global allocator.

pub fn with_capacity_in( data_capacity: usize, items_capacity: usize, allocator: A, ) -> Result<Self, StringTapeError>

Creates a new BytesTape with pre-allocated capacity and a custom allocator.

pub fn push(&mut self, bytes: &[u8]) -> Result<(), StringTapeError>

Adds bytes to the end of the tape.

pub fn get(&self, index: usize) -> Option<&[u8]>

Returns a reference to the bytes at the given index, or None if out of bounds.

pub fn len(&self) -> usize

Returns the number of items in the tape.

pub fn is_empty(&self) -> bool

Returns true if the tape contains no items.

pub fn data_len(&self) -> usize

Returns the total number of bytes used by data.

pub fn data_capacity(&self) -> usize

Returns the number of bytes allocated for data.

pub fn clear(&mut self)

Removes all items from the tape, keeping allocated capacity.

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

Shortens the tape, keeping the first len items and dropping the rest.

pub fn extend<I>(&mut self, iter: I) -> Result<(), StringTapeError>

where I: IntoIterator, I::Item: AsRef<[u8]>,

Extends the tape with the contents of an iterator of bytes.

pub fn as_raw_parts(&self) -> (*const u8, *const Offset, usize, usize)

Returns the raw parts of the tape for Apache Arrow compatibility.

pub fn allocator(&self) -> &A

Returns a reference to the allocator used by this BytesTape.

Trait Implementations

impl<Offset: OffsetType, A: Allocator> Index<usize> for BytesTape<Offset, A>

type Output = [u8]

The returned type after indexing.

fn index(&self, index: usize) -> &Self::Output

Performs the indexing (container[index]) operation.