Struct tokio_cache::AsyncCache

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

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

Methods

impl<K, V> AsyncCache<K, V> where
    K: Hash + Eq + Clone,
    V: Clone, 

pub fn new() -> Self

pub fn read<BK: ?Sized>(&self, key: &BK) -> Option<V> where
    BK: Hash + Eq,
    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> Default for AsyncCache<K, V> where
    K: Hash + Eq + Clone + Debug,
    V: Clone + Debug, 

fn default() -> Self

Returns the "default value" for a type.

impl<K: Clone, V: Clone> Clone for AsyncCache<K, V> where
    K: Hash + Eq + Clone,
    V: Clone, 

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

Returns a copy 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.