Struct PhonemeCache 

pub struct PhonemeCache { /* private fields */ }

Thread-safe LRU cache for phoneme conversion results

Implementations

impl PhonemeCache

pub fn new(capacity: usize) -> Self

Create a new phoneme cache with the specified capacity

Arguments

• capacity - Maximum number of entries to cache (minimum: 10)

Example

use voirs_cli::performance::phoneme_cache::PhonemeCache;

let cache = PhonemeCache::new(1000);

pub fn get_or_compute<F>( &self, text: &str, language: &str, backend: &str, compute_fn: F, ) -> Vec<String>

where F: FnOnce() -> Vec<String>,

Get phonemes from cache or compute them if not found

Arguments

• text - Input text
• language - Language code (e.g., “en”, “ja”)
• backend - G2P backend identifier
• compute_fn - Function to compute phonemes if not in cache

Returns

Vector of phoneme strings

Example

let cache = PhonemeCache::new(1000);

let phonemes = cache.get_or_compute("hello", "en", "phonetisaurus", || {
    // This expensive computation only runs on cache miss
    vec!["h".to_string(), "ə".to_string(), "l".to_string(), "oʊ".to_string()]
});

pub fn clear(&self)

Clear all cache entries

Example

let cache = PhonemeCache::new(1000);
cache.clear();

pub fn stats(&self) -> CacheStats

Get current cache statistics

Example

let cache = PhonemeCache::new(1000);
let stats = cache.stats();
println!("Hit rate: {:.1}%", stats.hit_rate * 100.0);
println!("Cache entries: {}/{}", stats.entries, stats.capacity);

pub fn resize(&mut self, new_capacity: usize)

Resize the cache capacity

Arguments

• new_capacity - New maximum number of entries

Example

let cache = PhonemeCache::new(1000);
cache.resize(2000); // Increase capacity to 2000

pub fn contains(&self, text: &str, language: &str, backend: &str) -> bool

Check if a specific text is in the cache

Arguments

• text - Input text
• language - Language code
• backend - G2P backend identifier

Returns

true if the entry exists in cache, false otherwise

pub fn len(&self) -> usize

Get the current number of cache entries

pub fn is_empty(&self) -> bool

Check if the cache is empty

pub fn capacity(&self) -> usize

Get cache capacity

pub fn global(capacity: usize) -> Arc<Self>

Create a global phoneme cache instance

This is useful for sharing a single cache across the entire application.

Trait Implementations

impl Clone for PhonemeCache

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for PhonemeCache

fn default() -> Self

Create a default cache with capacity of 1000 entries