Struct CacheStats 

pub struct CacheStats { /* private fields */ }

Statistics for cache operations.

All counters are atomic and can be safely accessed from multiple threads. Use Cache::stats() to get a snapshot of the current statistics.

Example

let cache = Cache::new(CacheConfig::default());
cache.set("key", "value");
let stats = cache.stats();
println!("Cache size: {}", stats.size());

Implementations

impl CacheStats

pub fn new() -> Self

Create a new stats instance with all counters at zero.

pub fn record_hit(&self)

Record a cache hit.

pub fn record_miss(&self)

Record a cache miss.

pub fn record_eviction(&self)

Record an eviction (due to capacity).

pub fn record_expiration(&self)

Record an expiration (due to TTL).

pub fn record_set(&self)

Record a set operation.

pub fn record_delete(&self)

Record a delete operation.

pub fn increment_size(&self)

Increment the size counter.

pub fn decrement_size(&self)

Decrement the size counter.

pub fn set_size(&self, size: u64)

Set the size to a specific value.

pub fn hits(&self) -> u64

Get the number of cache hits.

pub fn misses(&self) -> u64

Get the number of cache misses.

pub fn evictions(&self) -> u64

Get the number of evictions.

pub fn expirations(&self) -> u64

Get the number of expirations.

pub fn size(&self) -> u64

Get the current cache size.

pub fn sets(&self) -> u64

Get the total number of set operations.

pub fn deletes(&self) -> u64

Get the total number of delete operations.

pub fn hit_rate(&self) -> f64

Calculate the hit rate as a percentage (0.0 to 100.0). Returns 0.0 if no operations have been performed.

pub fn snapshot(&self) -> StatsSnapshot

Create a snapshot of the current statistics. This is useful for serialization or logging.

Trait Implementations

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.