Struct StringInterner 

pub struct StringInterner { /* private fields */ }

A thread-safe string interner that deduplicates strings with ID mapping

Implementations

impl StringInterner

pub fn new() -> Self

Create a new string interner with ID mapping

pub fn with_capacity(capacity: usize) -> Self

Create a new string interner with specified capacity

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

Intern a string, returning an Arc that can be cheaply cloned and compared

pub fn intern_with_id(&self, s: &str) -> (Arc<str>, u32)

Intern a string and return both the Arc and its numeric ID

pub fn get_id(&self, s: &str) -> Option<u32>

Get the ID for a string if it’s already interned

pub fn get_string(&self, id: u32) -> Option<Arc<str>>

Get the string for an ID if it exists

pub fn get_all_mappings(&self) -> Vec<(u32, Arc<str>)>

Get all ID mappings (useful for serialization/debugging)

pub fn cleanup(&self)

Clean up expired weak references to save memory

pub fn stats(&self) -> InternerStats

Get current statistics

pub fn len(&self) -> usize

Get the number of unique strings currently stored

pub fn id_mapping_count(&self) -> usize

Get the number of strings with ID mappings

pub fn is_empty(&self) -> bool

Check if the interner is empty

pub fn intern_batch(&self, strings: &[&str]) -> Vec<Arc<str>>

Batch intern multiple strings for improved performance Returns a Vec of Arc in the same order as input

pub fn prefetch(&self, strings: &[&str])

Prefetch strings into the interner cache for improved performance This is useful when you know you’ll need certain strings soon

pub fn memory_usage(&self) -> MemoryUsage

Get memory usage statistics for performance monitoring

pub fn optimize(&self)

Optimize the interner by cleaning up and compacting data structures

Trait Implementations

impl Debug for StringInterner

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

Formats the value using the given formatter.

impl Default for StringInterner

fn default() -> Self

Returns the “default value” for a type.