Struct StrList 

pub struct StrList { /* private fields */ }

An immutable, compact representation of a list of string slices.

StrList is the “frozen” counterpart to StrStack. It stores the same data (a contiguous UTF-8 byte buffer plus a u32 boundary table) but uses boxed slices instead of Vecs, shedding excess capacity.

Typically created by converting a finished StrStack via From<StrStack> or by collecting an iterator of &str.

Invariants

• data is always valid UTF-8.
• ends values are monotonically non-decreasing and the last value does not exceed data.len().

Implementations

impl StrList

pub fn len(&self) -> usize

Returns the number of string segments.

pub fn is_empty(&self) -> bool

Returns true if the list contains no segments.

pub fn bytes_len(&self) -> u32

Returns the total byte length of the data buffer.

pub fn as_str(&self) -> &str

Returns the concatenation of all segments as a single &str.

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

Returns the segment at index, or None if out of bounds.

pub fn get_bounds(&self, index: usize) -> Option<(u32, u32)>

Returns the byte offset bounds (start, end) for the segment at index.

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

Returns the last segment, or None if empty.

pub fn as_ref(&self) -> StrListRef<'_>

Returns a borrowed view over this list.

pub fn iter(&self) -> StrListIter<'_>

Returns an iterator over the string segments.

Trait Implementations

impl Clone for StrList

fn clone(&self) -> StrList

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StrList

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for StrList

Available on crate feature serde only.

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'a> From<&'a StrList> for StrListRef<'a>

fn from(list: &'a StrList) -> Self

Converts to this type from the input type.

impl From<StrStack> for StrList

fn from(stack: StrStack) -> Self

Converts to this type from the input type.

impl<'a> FromIterator<&'a str> for StrList

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

Creates a value from an iterator.

impl<'a> IntoIterator for &'a StrList

type Item = &'a str

The type of the elements being iterated over.

type IntoIter = StrListIter<'a>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl PartialEq for StrList

fn eq(&self, other: &StrList) -> 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 StrList

Available on crate feature serde only.

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl Eq for StrList

impl StructuralPartialEq for StrList