Struct Entry

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

A snapshot of a single entry in the cache.

Entry is constructed from the methods like or_insert on the struct returned by cache’s entry or entry_by_ref methods. Entry holds the cached key and value at the time it was constructed. It also carries extra information about the entry; is_fresh method returns true if the value was not cached and was freshly computed.

See the followings for more information about entry and entry_by_ref methods:

• sync::Cache:
  • entry
  • entry_by_ref
• future::Cache:
  • entry
  • entry_by_ref

Implementations

impl<K, V> Entry<K, V>

pub fn key(&self) -> &K

Returns a reference to the wrapped key.

pub fn value(&self) -> &V

Returns a reference to the wrapped value.

Note that the returned reference is not pointing to the original value in the cache. Instead, it is pointing to the cloned value in this Entry.

pub fn into_value(self) -> V

Consumes this Entry, returning the wrapped value.

Note that the returned value is a clone of the original value in the cache. It was cloned when this Entry was constructed.

pub fn is_fresh(&self) -> bool

Returns true if the value in this Entry was not cached and was freshly computed.

pub fn is_old_value_replaced(&self) -> bool

Returns true if an old value existed in the cache and was replaced by the value in this Entry.

Note that the new value can be the same as the old value. This method still returns true in that case.

Trait Implementations

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

where K: Debug, V: Debug,

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

Formats the value using the given formatter.