Struct CacheStats 

pub struct CacheStats { /* private fields */ }

Accumulates cache hit/miss counters and produces derived statistics.

Implementations

impl CacheStats

pub fn new() -> Self

Create a new CacheStats with all counters at zero.

pub fn record_hit(&mut self)

Record one cache hit.

pub fn record_miss(&mut self)

Record one cache miss.

pub fn record_eviction(&mut self)

Record one eviction.

pub fn hits(&self) -> u64

Total number of hits.

pub fn misses(&self) -> u64

Total number of misses.

pub fn evictions(&self) -> u64

Total number of evictions.

pub fn total_lookups(&self) -> u64

Total number of lookups (hits + misses).

pub fn hit_rate(&self) -> f32

Hit rate as a fraction in [0.0, 1.0].

Returns 0.0 when no lookups have occurred.

pub fn miss_rate(&self) -> f32

Miss rate as a fraction in [0.0, 1.0].

pub fn to_json(&self) -> String

Export statistics as a compact JSON string.

Format

{"hits":10,"misses":5,"evictions":2,"hit_rate":0.666667}

pub fn reset(&mut self)

Reset all counters to zero.

Trait Implementations

impl Clone for CacheStats

fn clone(&self) -> CacheStats

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CacheStats

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

Formats the value using the given formatter.

impl Default for CacheStats

fn default() -> CacheStats

Returns the “default value” for a type.