Struct OwnedString 

pub struct OwnedString { /* private fields */ }

Independently owned UTF-8 text with retained capacity accounting.

Only valid UTF-8 may be appended; raw mutable bytes are never exposed. Borrowing as str uses safe UTF-8 validation and admits its scan first. This avoids an additional unchecked conversion outside the allocator adapter.

Implementations

impl OwnedString

pub fn memory(&self) -> &Memory

The domain retaining this text’s storage.

pub fn len(&self) -> usize

The initialized UTF-8 length in bytes.

pub fn is_empty(&self) -> bool

Whether this text contains no characters.

pub fn capacity(&self) -> usize

Allocated byte capacity, retained until this text is dropped.

pub fn as_str(&self, execution: &Memory) -> Result<&str, MemoryError>

Borrows the text without copying, charging safe UTF-8 validation to the current execution domain, independently of the retained storage domain.

Panics

Panics if the private UTF-8 invariant is violated. Safe construction and append operations preserve that invariant.

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

The UTF-8 bytes, as an allocation-free view; callers account traversal.

pub fn try_push_str(&mut self, text: &str) -> Result<(), MemoryError>

Appends valid UTF-8 after admitting capacity and copying work.

pub fn try_push(&mut self, character: char) -> Result<(), MemoryError>

Appends one scalar using a fixed stack buffer, without hidden allocation.

pub fn try_copy(&self) -> Result<Self, MemoryError>

Creates an independently charged copy in the same domain.

Trait Implementations

impl Debug for OwnedString

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

Formats the value using the given formatter.