Struct TimedCache

pub struct TimedCache<K, V>(Arc<TimedCacheInner<K, V>>);

A cache with entries that “expire” after a per-cache time limit

Tuple Fields

0: Arc<TimedCacheInner<K, V>>

Implementations

impl<K, V> TimedCache<K, V>

where K: Eq + Hash + 'static, V: 'static,

pub fn new() -> Self

Create a cache with timed entries with a default expire time

pub fn get_if_fresh<Q>(&self, key: &Q) -> Option<Arc<TimedCacheEntry<V>>>

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

Get a value if fresh, or None if it doesn’t exist or is expired

pub fn get_random_if_fresh(&self) -> Option<Arc<TimedCacheEntry<V>>>

Get a random fresh value

pub fn insert(&self, key: K, value: V)

Insert a K/V

pub fn insert_and_get(&self, key: K, value: V) -> Arc<TimedCacheEntry<V>>

Insert a K/V and return the data for the newly inserted value

pub fn trim(&self) -> bool

Trims expired entries

pub fn force_trim(&self)

Trims expired entries, ignoring last trim time.

pub fn len(&self) -> usize

Gets the number of entries. Includes expired entries.

pub fn is_empty(&self) -> bool

Checks if cache is empty. Included expired entries.

Trait Implementations

impl<K, V> Clone for TimedCache<K, V>

where K: Eq + Hash + 'static, V: 'static,

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<K, V> Debug for TimedCache<K, V>

where K: Eq + Debug + Hash, V: Debug,

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

Formats the value using the given formatter.

impl<K, V> Default for TimedCache<K, V>

where K: Eq + Hash + 'static, V: 'static,

fn default() -> Self

Returns the “default value” for a type.