Struct StringInterner 

pub struct StringInterner { /* private fields */ }

A thread-safe string interning pool.

Wraps an Arc<Mutex<InternPool>> so multiple owners can share the same underlying storage. The global singleton is accessible via intern and resolve; StringInterner can also be used as a standalone local interner in tests or as an injected dependency.

Implementations

impl StringInterner

pub fn new() -> Self

Creates a new StringInterner backed by a fresh InternPool.

pub fn shared_with(other: &StringInterner) -> Self

Creates a StringInterner sharing the backing pool with other.

pub fn intern(&self, s: &str) -> InternedStr

Interns s and returns an InternedStr handle.

Acquiring the lock returns an error only if the mutex is poisoned (a panic occurred while the lock was held). In that case this method panics with a descriptive message rather than silently continuing.

pub fn resolve(&self, handle: InternedStr) -> Option<&'static str>

Resolves handle to its &'static str content.

Returns None if the handle was not produced by this interner.

pub fn len(&self) -> usize

Returns the number of distinct strings stored.

pub fn is_empty(&self) -> bool

Returns true when no strings have been interned.

pub fn total_bytes(&self) -> usize

Returns the total byte count of all interned strings.

pub fn arc_clone(&self) -> Arc<Mutex<InternPool>>

Clones the underlying Arc so the pool can be shared across threads.

Trait Implementations

impl Default for StringInterner

fn default() -> Self

Returns the “default value” for a type.