Struct CharsTape 

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

UTF-8 string view over RawTape.

Implementations

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

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

Creates a new, empty CharsTape with the global allocator.

pub fn new_in(allocator: A) -> Self

Creates a new, empty CharsTape with a custom allocator.

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

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

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

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

pub fn push(&mut self, s: &str) -> Result<(), StringTapeError>

Adds a string to the end of the CharsTape.

pub fn get(&self, index: usize) -> Option<&str>

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

pub fn len(&self) -> usize

Returns the number of strings in the CharsTape.

pub fn is_empty(&self) -> bool

Returns true if the CharsTape contains no strings.

pub fn data_len(&self) -> usize

Returns the total number of bytes used by string data.

pub fn capacity(&self) -> usize

Returns the number of strings currently stored (same as len()).

pub fn data_capacity(&self) -> usize

Returns the number of bytes allocated for string data.

pub fn offsets_capacity(&self) -> usize

Returns the number of offset slots allocated.

pub fn clear(&mut self)

Removes all strings from the CharsTape, keeping allocated capacity.

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

Shortens the CharsTape, keeping the first len strings and dropping the rest.

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

where I: IntoIterator, I::Item: AsRef<str>,

Extends the CharsTape with the contents of an iterator.

pub fn as_raw_parts(&self) -> RawParts<Offset>

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

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

Returns a slice view of the data buffer.

pub fn offsets_slice(&self) -> &[Offset]

Returns a slice view of the offsets buffer.

pub fn iter(&self) -> CharsTapeIter<'_, Offset, A>

pub fn allocator(&self) -> &A

Returns a reference to the allocator used by this CharsTape.

pub fn view(&self) -> CharsTapeView<'_, Offset>

Creates a view of the entire CharsTape.

pub fn subview( &self, start: usize, end: usize, ) -> Result<CharsTapeView<'_, Offset>, StringTapeError>

Creates a subview of a continuous slice of this CharsTape.

pub fn arrow_slices(&self) -> (&[u8], &[Offset])

Returns data and offsets slices for zero-copy Arrow conversion.

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

pub fn into_bytes_tape(self) -> BytesTape<Offset, A>

Trait Implementations

impl<Offset: OffsetType> Default for CharsTape<Offset, Global>

fn default() -> Self

Returns the “default value” for a type.

impl<Offset: OffsetType, A: Allocator> Drop for CharsTape<Offset, A>

fn drop(&mut self)

Executes the destructor for this type.

impl<Offset: OffsetType, A: Allocator> From<CharsTape<Offset, A>> for BytesTape<Offset, A>

fn from(chars_tape: CharsTape<Offset, A>) -> Self

Converts to this type from the input type.

impl<'a, Offset: OffsetType> FromIterator<&'a str> for CharsTape<Offset, Global>

fn from_iter<I: IntoIterator<Item = &'a str>>(iter: I) -> Self

Creates a value from an iterator.

impl<Offset: OffsetType> FromIterator<String> for CharsTape<Offset, Global>

fn from_iter<I: IntoIterator<Item = String>>(iter: I) -> Self

Creates a value from an iterator.

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

type Output = str

The returned type after indexing.

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

Performs the indexing (container[index]) operation.

impl<'a, Offset: OffsetType, A: Allocator> IntoIterator for &'a CharsTape<Offset, A>

type Item = &'a str

The type of the elements being iterated over.

type IntoIter = CharsTapeIter<'a, Offset, A>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<Offset: OffsetType, A: Allocator> TryFrom<BytesTape<Offset, A>> for CharsTape<Offset, A>

type Error = StringTapeError

The type returned in the event of a conversion error.

fn try_from(bytes_tape: BytesTape<Offset, A>) -> Result<Self, Self::Error>

Performs the conversion.

impl<Offset: OffsetType + Send, A: Allocator + Send> Send for CharsTape<Offset, A>

impl<Offset: OffsetType + Sync, A: Allocator + Sync> Sync for CharsTape<Offset, A>