Struct dynamic_lru_cache::DynamicCacheLocal

pub struct DynamicCacheLocal<K, V, S = RandomState> { /* fields omitted */ }

A cache that will only hold onto items that have been reqeuested more than once in recent memory. Single-use items are not held at all. Once an item is requested twice, it is cached until all memory of seeing it requested has expired. The length of the memory is adjustable, and must be set at initialization.

Implementations

impl<K: Clone + Eq + Hash, V, S> DynamicCacheLocal<K, V, S>

pub fn with_hasher(
    mem_len: usize,
    hash_builder: S
) -> DynamicCacheLocal<K, V, S>

Create and initialize a new cache, using the given hash builder to hash keys. The same warnings given for HashMap::with_hasher apply here.

impl<K: Clone + Eq + Hash, V> DynamicCacheLocal<K, V>

pub fn new(mem_len: usize) -> Self

Create and initialize a new cache.

pub fn get_or_insert<F: FnOnce() -> V>(&mut self, key: &K, f: F) -> Arc<V>

Fetch an item via the cache, potentially filling in the cache on a miss via the function f.

pub fn size(&self) -> usize

Get the number of items currently stored in the cache.

pub fn mem_len(&self) -> usize

Get the length of the cache’s recent request memory.

pub fn set_mem_len(&mut self, new_len: usize)

Change the length of the cache’s recent request memory. Some contents of the cache may be removed immediately if the new memory length is shorter than the old memory length.

pub fn clear_cache(&mut self)

Clear out all stored values and all memory in the cache.

pub fn hits(&self) -> u64

Get the number of hits this cache has seen.

pub fn misses(&self) -> u64

Get the number of misses this cache has seen.

pub fn reset_metrics(&mut self)

Reset the cache hit/miss metrics.

Trait Implementations

impl<K: Debug, V: Debug, S> Debug for DynamicCacheLocal<K, V, S>

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

Formats the value using the given formatter.