Struct CacheStats 

pub struct CacheStats {
    pub hit_count: u64,
    pub miss_count: u64,
    pub insert_count: u64,
    pub evict_count: u64,
    /* private fields */
}

Statistics collected by a ClawCache instance.

Retrieve via crate::ClawEngine::cache_stats.

Example

use claw_core::CacheStats;
let stats = CacheStats::new();
assert_eq!(stats.hit_ratio(), 0.0);

Fields

hit_count: u64

Number of cache lookups that found an entry.

miss_count: u64

Number of cache lookups that found no entry.

insert_count: u64

Total number of entries inserted into the cache.

evict_count: u64

Total number of entries evicted from the cache.

Implementations

impl CacheStats

pub fn new() -> Self

Create a zeroed CacheStats.

Example

use claw_core::CacheStats;
let s = CacheStats::new();
assert_eq!(s.hit_count, 0);

pub fn rolling_hit_rate(&self) -> f64

Cache hit rate over the most recent 1 000 lookups (0.0 – 1.0).

Returns 0.0 when fewer than one lookup has been recorded.

pub fn hit_ratio(&self) -> f64

Cache hit ratio as a value between 0.0 and 1.0.

Returns 0.0 if no lookups have been performed yet.

Example

use claw_core::CacheStats;
let mut s = CacheStats::new();
s.hit_count = 3;
s.miss_count = 1;
assert!((s.hit_ratio() - 0.75).abs() < f64::EPSILON);

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.