Struct Stats 

pub struct Stats {
    pub hits: u64,
    pub promotions: u64,
    pub misses: u64,
    pub inserts: u64,
    pub updates: u64,
    pub flips: u64,
    pub entries: usize,
    pub peak_entries: usize,
    pub cap: usize,
}

What a cache has done since it was created or reset: see LruCache::stats.

Lookups are get, get_mut and the two get_or_insert_with methods; each is a hit, a promotion or a miss. put is not a lookup: it counts as an insert or an update.

Fields

hits: u64

Lookups found in the current generation.

promotions: u64

Lookups found in the previous generation (moved back into the current one). These are hits too, but they survived only because that generation had not been dropped yet: many of them mean the keys in use slightly outnumber cap.

misses: u64

Lookups that found nothing.

inserts: u64

New keys added, by put or by a read-through’s miss.

updates: u64

put calls on a key already in the cache.

flips: u64

Flips: how often the current generation filled up.

entries: usize

Entries held now, in both generations (up to 2 * cap).

peak_entries: usize

The most entries ever held: the memory the workload actually needed.

cap: usize

The cache’s capacity.

Implementations

impl Stats

pub fn lookups(&self) -> u64

Hits, promotions and misses together.

pub fn hit_ratio(&self) -> f64

The share of lookups that found their key (hits and promotions), from 0.0 to 1.0; 0.0 before any lookup.

pub fn flips_per_1000_lookups(&self) -> f64

Flips per 1000 lookups. At most 1000 / cap (every lookup a new key).

pub fn sizing(&self) -> Sizing

A verdict on the capacity, from these counts. See Sizing for what each means and what to do.

Trait Implementations

impl Clone for Stats

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Stats

impl Debug for Stats

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

Formats the value using the given formatter.

impl Eq for Stats

impl PartialEq for Stats

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Stats