Struct StringPool 

pub struct StringPool { /* private fields */ }

A string pool that deduplicates strings using reference counting.

Strings are stored as Arc<str>, allowing multiple references to the same string without duplication. The pool maintains a weak reference to each string, allowing unused strings to be garbage collected.

Implementations

impl StringPool

pub fn new() -> Self

Creates a new empty string pool.

pub fn with_capacity(capacity: usize) -> Self

Creates a string pool with the specified capacity.

pub fn intern(&mut self, s: &str) -> Arc<str>

Interns a string, returning a reference-counted handle.

If the string already exists in the pool, returns a clone of the existing Arc<str>. Otherwise, creates a new entry.

pub fn intern_string(&mut self, s: String) -> Arc<str>

Interns a string from an owned String.

This is more efficient than intern when you already have a String, as it avoids an extra allocation if the string is not already pooled.

pub fn len(&self) -> usize

Returns the number of unique strings in the pool.

pub fn is_empty(&self) -> bool

Returns true if the pool is empty.

pub fn clear(&mut self)

Clears all strings from the pool.

pub fn memory_usage(&self) -> usize

Returns the memory usage of the pool in bytes (approximate).

This includes the HashMap overhead and the string data.

pub fn stats(&self) -> StringPoolStats

Returns statistics about the string pool.

Trait Implementations

impl Debug for StringPool

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

Formats the value using the given formatter.

impl Default for StringPool

fn default() -> StringPool

Returns the “default value” for a type.