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 unsafe fn get_unchecked(&self, index: usize) -> &str

Returns a reference to the string at the given index without bounds checking.

Safety

Caller must ensure index < self.len().

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 first(&self) -> Option<&str>

Returns a reference to the first string, or None if empty.

pub fn last(&self) -> Option<&str>

Returns a reference to the last string, or None if empty.

pub fn pop(&mut self) -> Option<()>

Removes and returns the last string, or None if empty.

pub fn contains(&self, item: &str) -> bool

Returns true if the tape contains the given string.

pub fn shrink_to_fit(&mut self) -> Result<(), StringTapeError>

Shrinks allocated capacity to fit current data.

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 as_reorderable<Length: LengthType>( &self, ) -> Result<CharsCows<'_, Offset, Length>, StringTapeError>

Creates a CharsCows view of the tape.

Example

let mut tape = CharsTapeI32::new();
tape.extend(["apple", "banana", "cherry"])?;

let cows: CharsCows<i32, u16> = tape.as_reorderable()?;
assert_eq!(cows.get(0), Some("apple"));

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, A: Allocator + Clone> Clone for CharsTape<Offset, A>

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

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

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

Formats the value using the given formatter.

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<'a, Offset: OffsetType, A: Allocator> Extend<&'a str> for CharsTape<Offset, A>

fn extend<I: IntoIterator<Item = &'a str>>(&mut self, iter: I)

Extends a collection with the contents of an iterator.

fn extend_one(&mut self, item: A)

🔬This is a nightly-only experimental API. (extend_one)

Extends a collection with exactly one element.

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.

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> Hash for CharsTape<Offset, A>

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

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> Ord for CharsTape<Offset, A>

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

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

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

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

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

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, A: Allocator> Eq for CharsTape<Offset, A>

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

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