Struct BlockingLruCache 

pub struct BlockingLruCache<K, V> { /* private fields */ }

A minimal LRU cache protected by a Tokio mutex. Calls outside a Tokio runtime are no-ops.

Implementations

impl<K, V> BlockingLruCache<K, V>

where K: Eq + Hash,

pub fn new(capacity: NonZeroUsize) -> Self

Creates a cache with the provided non-zero capacity.

pub fn get_or_insert_with(&self, key: K, value: impl FnOnce() -> V) -> V

where V: Clone,

Returns a clone of the cached value for key, or computes and inserts it.

pub fn get_or_try_insert_with<E>( &self, key: K, value: impl FnOnce() -> Result<V, E>, ) -> Result<V, E>

where V: Clone,

Like get_or_insert_with, but the value factory may fail.

pub fn try_with_capacity(capacity: usize) -> Option<Self>

Builds a cache if capacity is non-zero, returning None otherwise.

pub fn get<Q>(&self, key: &Q) -> Option<V>

where K: Borrow<Q>, Q: Hash + Eq + ?Sized, V: Clone,

Returns a clone of the cached value corresponding to key, if present.

pub fn insert(&self, key: K, value: V) -> Option<V>

Inserts value for key, returning the previous entry if it existed.

pub fn remove<Q>(&self, key: &Q) -> Option<V>

where K: Borrow<Q>, Q: Hash + Eq + ?Sized,

Removes the entry for key if it exists, returning it.

pub fn clear(&self)

Clears all entries from the cache.

pub fn with_mut<R>(&self, callback: impl FnOnce(&mut LruCache<K, V>) -> R) -> R

Executes callback with a mutable reference to the underlying cache.

pub fn blocking_lock(&self) -> Option<MutexGuard<'_, LruCache<K, V>>>

Provides direct access to the cache guard when a Tokio runtime is available.