Struct AsyncCache

pub struct AsyncCache<K, V>
where
    K: Hash + Eq + Clone,
    V: Clone,
{ /* private fields */ }

A cache where reads are wait-free and where writes are asynchronous, such as it can be used within code that cannot block.

Implementations

impl<K, V> AsyncCache<K, V>

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

pub fn new() -> Self

pub fn read<BK>(&self, key: &BK) -> Option<V>

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

Reads the cached entry for the given key.

Note that this will not block.

pub async fn write<F, E>(&self, key: K, future: F) -> Result<V, E>

where F: Future<Output = Result<V, E>>,

Writes the result of the given future in the cache at entry key.

If multiple writes, concurrent or not, on the same key are issued, only one of the futures will be polled and the others will be dropped.

Trait Implementations

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

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

fn clone(&self) -> AsyncCache<K, V>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

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

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

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

Formats the value using the given formatter.

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

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

fn default() -> Self

Returns the “default value” for a type.