Struct StringInterner 

pub struct StringInterner { /* private fields */ }

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

Integrates SciRS2-core metrics for production-grade performance monitoring:

• Automatic cache hit/miss tracking
• Intern operation timing
• Memory usage histograms
• Deduplication effectiveness metrics

Implementations

impl StringInterner

pub fn new() -> Self

Create a new string interner with ID mapping and SciRS2 metrics

Automatically tracks:

• Cache hit/miss rates for intern operations
• Operation timing for performance analysis
• String length distribution
• Memory usage patterns

pub fn with_capacity(capacity: usize) -> Self

Create a new string interner with specified capacity

Pre-allocates HashMaps to the given capacity to reduce reallocation overhead. Initializes all SciRS2 metrics for comprehensive monitoring.

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

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

This operation is tracked with SciRS2 metrics:

• Cache hits/misses
• Operation timing
• String length distribution

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

Intern a string and return both the Arc<str> 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) -> usize

Clean up expired weak references to save memory

Returns the number of entries cleaned up

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<str> 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 get_metrics(&self) -> InternerMetrics

Get comprehensive performance metrics from SciRS2

Returns detailed statistics including:

• Cache hit/miss counts and ratios
• Operation timing statistics
• String length distribution
• Memory usage patterns

pub fn optimize(&self)

Optimize the interner by cleaning up and compacting data structures

Performs comprehensive optimization:

• Cleans up expired weak references
• Rehashes HashMaps with optimal capacity
• Updates memory usage statistics
• Tracks optimization impact with SciRS2 metrics

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.