Struct StrListRef 

pub struct StrListRef<'a> { /* private fields */ }

A borrowed, read-only view over string list data.

StrListRef borrows &[u8] (data) and &[u32] (boundary table) and provides the same read-only API as StrList. Use it for zero-copy views over external buffers (e.g., memory-mapped files).

Invariants

Same as StrList: data is valid UTF-8 and ends are valid boundaries. When constructed via new, these invariants are validated. When constructed via From<&StrStack> or From<&StrList>, they are inherited.

Implementations

impl<'a> StrListRef<'a>

pub fn new( data: &'a [u8], ends: &'a [u32], ) -> Result<Self, StrListValidationError>

Creates a StrListRef from raw data and boundary slices, validating UTF-8 and boundary consistency.

Validation checks (O(total bytes)):

• ends values are monotonically non-decreasing
• Last value does not exceed data.len()
• Each segment data[ends[i-1]..ends[i]] (with ends[-1] = 0) is valid UTF-8

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) -> &'a str

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

pub fn get(&self, index: usize) -> Option<&'a 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<&'a str>

Returns the last segment, or None if empty.

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

Returns an iterator over the string segments.

Trait Implementations

impl<'a> Clone for StrListRef<'a>

fn clone(&self) -> StrListRef<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for StrListRef<'a>

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

Formats the value using the given formatter.

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

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

Converts to this type from the input type.

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

fn from(stack: &'a StrStack) -> Self

Converts to this type from the input type.

impl<'a> IntoIterator for StrListRef<'a>

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<'a> PartialEq for StrListRef<'a>

fn eq(&self, other: &StrListRef<'a>) -> 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<'a> Copy for StrListRef<'a>

impl<'a> Eq for StrListRef<'a>

impl<'a> StructuralPartialEq for StrListRef<'a>