Struct RcuCache 

pub struct RcuCache<K, V, S = RapidBuildHasher>
where
    K: Eq + Hash + Clone + Send + Sync + 'static,
    V: Clone + Send + Sync + 'static,
    S: BuildHasher + Send + Sync + 'static,
{ /* private fields */ }

A cache that uses RCU to provide thread-safe access to a hash map.

This is similar to RcuHashMap, but it also evicts items when the cache exceeds a specified capacity.

Entries are evicted in a FIFO manner.

By default, this map uses rapidhash::RapidBuildHasher, which provides high performance. However, if this map holds keys which may be attacker-controlled, consider using std::collections::hash_map::RandomState instead.

Implementations

impl<K, V> RcuCache<K, V, RapidBuildHasher>

where K: Eq + Hash + Clone + Send + Sync + 'static, V: Clone + Send + Sync + 'static,

pub fn new(capacity: usize) -> Self

Creates a new RcuCache with the specified capacity.

impl<K, V, S> RcuCache<K, V, S>

where K: Eq + Hash + Clone + Send + Sync + 'static, V: Clone + Send + Sync + 'static, S: BuildHasher + Send + Sync + 'static,

pub fn with_capacity_and_hasher(capacity: usize, hash_builder: S) -> Self

Creates a new RcuCache with the specified capacity and hasher.

impl<K, V, S> RcuCache<K, V, S>

where K: Eq + Hash + Clone + Send + Sync + 'static, V: Clone + Send + Sync + 'static, S: BuildHasher + Send + Sync + 'static,

pub fn capacity(&self) -> usize

Returns the capacity with which this instance was initialized.

pub fn len(&self) -> usize

Returns the number of entries in the cache.

pub fn get<'a>(&self, scope: &'a RcuReadScope, key: &K) -> Option<&'a V>

Returns a reference to the value associated with the key.

pub fn lock(&self) -> RcuCacheGuard<'_, K, V, S>

pub fn clear(&self)

Removes all entries from the cache.

Trait Implementations

impl<K, V, S> Debug for RcuCache<K, V, S>

where K: Eq + Hash + Clone + Send + Sync + 'static + Debug, V: Clone + Send + Sync + 'static + Debug, S: BuildHasher + Send + Sync + 'static + Debug,

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

Formats the value using the given formatter.