Struct SeqString 

pub struct SeqString { /* private fields */ }

Byte string that tracks its allocation source.

Safety Invariants

• If global=true: ptr points to a global-allocated byte buffer whose memory matches len/capacity; the buffer is freed on Drop.
• If global=false: ptr points into the thread-local arena; the arena owns the memory and frees it in bulk on strand exit.
• The byte content is not required to be valid UTF-8.
• For global strings: capacity must match the original Vec<u8>’s capacity so deallocation is correctly sized.

Implementations

impl SeqString

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

Borrow the underlying bytes. Always succeeds; the type carries no UTF-8 invariant. Byte-clean operations (concat, byte length, equality, search, network I/O, crypto, etc.) should use this.

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

View as &str if the bytes happen to be valid UTF-8.

Text-level operations (codepoint counting, case folding, string.json-escape, regex.* with Unicode classes, formatting for display) call this and treat None as a fallible-text failure — the conventional (value Bool) failure tuple, returning -1 / empty string / false per the surrounding op’s contract.

pub fn as_str_lossy(&self) -> Cow<'_, str>

View as &str, replacing any invalid UTF-8 with U+FFFD. Use only for human-facing display where lossiness is acceptable (Debug, panic messages, REPL output). Operations that round- trip user data must use [as_bytes] or [as_str] instead.

pub fn as_str_or_empty(&self) -> &str

View as &str, returning "" if the bytes aren’t valid UTF-8.

The convenience for text-required ops (string.length, string.find, file paths, integer parsing, …) that expect a &str and have an existing degenerate-result-or-failure-tuple path for empty input. A non-UTF-8 input lands in that same failure path, with no extra branching at every call site.

pub fn is_global(&self) -> bool

Check if this string is globally allocated

pub fn len(&self) -> usize

Get length in bytes

pub fn is_empty(&self) -> bool

Check if empty

pub fn is_interned(&self) -> bool

Check if this is an interned/static string (Issue #166)

Interned strings have capacity=0 and point to static data. They are never freed and can be compared by pointer for O(1) equality.

pub fn as_ptr(&self) -> *const u8

Get raw pointer to string data

Used for O(1) pointer comparison of interned symbols.

pub unsafe fn from_raw_parts( ptr: *const u8, len: usize, capacity: usize, global: bool, ) -> SeqString

Reconstruct SeqString from raw parts

Safety

The parts must be a valid allocation matching the ptr/len/capacity/global invariants documented on SeqString.

Trait Implementations

impl Clone for SeqString

fn clone(&self) -> SeqString

Clone always allocates from the global allocator for Send safety.

When a SeqString is sent through a channel, the receiving strand gets an independent global-allocated copy that doesn’t depend on the sender’s arena. Byte-clean: copies the underlying &[u8], no UTF-8 validation.

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

Performs copy-assignment from source.

impl Debug for SeqString

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

Formats the value using the given formatter.

impl Display for SeqString

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

Formats the value using the given formatter.

impl Drop for SeqString

fn drop(&mut self)

Executes the destructor for this type.

impl From<&str> for SeqString

Convert &str to SeqString using arena allocation

fn from(s: &str) -> SeqString

Converts to this type from the input type.

impl From<String> for SeqString

Convert String to SeqString using global allocation

fn from(s: String) -> SeqString

Converts to this type from the input type.

impl PartialEq for SeqString

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

impl Send for SeqString

impl Sync for SeqString