Struct CacheStats 

pub struct CacheStats {
    pub size: usize,
    pub capacity: usize,
    pub hits: u64,
    pub misses: u64,
    pub hit_rate: f64,
}

Cache statistics.

Fields

size: usize

Current number of entries.

capacity: usize

Maximum capacity.

hits: u64

Total cache hits.

misses: u64

Total cache misses.

hit_rate: f64

Hit rate (0.0 to 1.0).

Implementations

impl CacheStats

pub fn new(size: usize, capacity: usize, hits: u64, misses: u64) -> Self

Create new cache statistics.

Example

use chie_shared::types::cache::CacheStats;

let stats = CacheStats::new(750, 1000, 8500, 1500);

assert_eq!(stats.size, 750);
assert_eq!(stats.capacity, 1000);
assert_eq!(stats.hits, 8500);
assert_eq!(stats.misses, 1500);
assert_eq!(stats.hit_rate, 0.85);
assert_eq!(stats.total_requests(), 10000);
assert!((stats.miss_rate() - 0.15).abs() < 1e-10);
assert_eq!(stats.fill_percentage(), 0.75);

pub fn empty(capacity: usize) -> Self

Create empty cache statistics.

pub fn is_full(&self) -> bool

Check if cache is full.

pub fn is_empty(&self) -> bool

Check if cache is empty.

pub fn fill_percentage(&self) -> f64

Get the fill percentage (0.0 to 1.0).

pub fn total_requests(&self) -> u64

Get total requests (hits + misses).

pub fn miss_rate(&self) -> f64

Get miss rate (0.0 to 1.0).

pub fn efficiency_score(&self) -> f64

Calculate efficiency score (0.0 to 100.0).

Combines hit rate (70% weight) and capacity utilization (30% weight).

Example

use chie_shared::types::cache::CacheStats;

// High efficiency: good hit rate and good utilization
let stats1 = CacheStats::new(900, 1000, 9000, 1000);
assert_eq!(stats1.efficiency_score(), 90.0 * 0.7 + 0.9 * 30.0);

// Medium efficiency: good hit rate but low utilization
let stats2 = CacheStats::new(300, 1000, 900, 100);
assert_eq!(stats2.efficiency_score(), 0.9 * 70.0 + 0.3 * 30.0);

// Low efficiency: poor hit rate
let stats3 = CacheStats::new(500, 1000, 300, 700);
assert_eq!(stats3.efficiency_score(), 0.3 * 70.0 + 0.5 * 30.0);

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() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for CacheStats

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for CacheStats

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for CacheStats

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for CacheStats