Struct Utf8Container 

pub struct Utf8Container<S: Storage = Cow> { /* private fields */ }

Implementations

impl Utf8Container<Cow>

pub fn new(data: Vec<String>) -> Self

pub fn from_vec(data: Vec<String>) -> Self

pub fn with_capacity(capacity: usize) -> Self

pub fn from_raw_parts(data: Vec<String>) -> Self

Reconstruct from a Vec of owned Strings (for compatibility with previous from_raw_parts(Vec<String>)).

pub fn from_bytes_offsets(data: Vec<u8>, offsets: Vec<u64>) -> Self

Build directly from contiguous bytes + offsets (zero-copy from the caller’s perspective). Caller must ensure the bytes are valid UTF-8 and offsets are well-formed.

pub fn try_into_raw_parts(self) -> Option<Vec<String>>

Try to decompose into a Vec<String> for compatibility with code paths that need owned strings. Always succeeds (allocates).

impl<S: Storage> Utf8Container<S>

pub fn from_inner(inner: VarlenContainer<S>) -> Self

pub fn from_storage_parts(data: S::Vec<u8>, offsets: S::Vec<u64>) -> Self

Construct from storage-generic data+offsets vectors. Used by arena conversion. Caller must ensure data is valid UTF-8 and offsets are well-formed (length >= 1, [0] == 0, monotonic non-decreasing, last <= data.len()).

pub fn data_storage(&self) -> &S::Vec<u8>

Borrow the inner data + offsets vectors.

pub fn offsets_storage(&self) -> &S::Vec<u64>

pub fn len(&self) -> usize

pub fn capacity(&self) -> usize

pub fn is_empty(&self) -> bool

pub fn clear(&mut self)

Storage-generic clear (works for any S: Storage).

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

Borrow the i-th string. UTF-8 validity is guaranteed by construction.

pub fn is_defined(&self, idx: usize) -> bool

pub fn is_fully_defined(&self) -> bool

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

Borrow the underlying concatenated payload bytes. Used by the FFI marshal path for zero-copy borrow.

pub fn offsets(&self) -> &[u64]

Borrow the underlying offsets array (length = len + 1).

pub fn inner(&self) -> &VarlenContainer<S>

Borrow the underlying VarlenContainer (test/debug only).

pub fn as_string(&self, index: usize) -> String

pub fn get_value(&self, index: usize) -> Value

pub fn iter(&self) -> impl Iterator<Item = Option<&str>> + '_

Iterate strings as Option<&str>. Always Some for indices < len.

pub fn iter_str(&self) -> impl Iterator<Item = &str> + '_

Iterate strings as &str directly.

impl Utf8Container<Cow>

pub fn push(&mut self, value: String)

pub fn push_str(&mut self, value: &str)

pub fn push_default(&mut self)

pub fn extend(&mut self, other: &Self) -> Result<()>

pub fn slice(&self, start: usize, end: usize) -> Self

pub fn filter(&mut self, mask: &<Cow as Storage>::BitVec)

pub fn reorder(&mut self, indices: &[usize])

pub fn take(&self, num: usize) -> Self

Trait Implementations

impl<S: Storage> Clone for Utf8Container<S>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<S: Storage> Debug for Utf8Container<S>

where VarlenContainer<S>: Debug,

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

Formats the value using the given formatter.

impl Default for Utf8Container<Cow>

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Utf8Container<Cow>

fn deserialize<D: Deserializer<'de>>( deserializer: D, ) -> StdResult<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl<S: Storage> PartialEq for Utf8Container<S>

where VarlenContainer<S>: PartialEq,

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 Serialize for Utf8Container<Cow>

fn serialize<Ser: Serializer>( &self, serializer: Ser, ) -> StdResult<Ser::Ok, Ser::Error>

Serialize this value into the given Serde serializer.