Struct CacheStatsHandler 

pub struct CacheStatsHandler { /* private fields */ }

A stats handler for fixed-cache that tracks collisions and size.

Note: Hits and misses are tracked directly by the CachedStateProvider via CachedStateMetrics, not here. The stats handler is used for:

• Collision detection (hash collisions causing eviction of a different key)
• Size tracking

Size Tracking

Size is tracked via on_insert and on_remove callbacks:

• on_insert: increment size only when inserting into an empty bucket (no eviction)
• on_remove: always decrement size

Collisions (evicting a different key) don’t change size since they replace an existing entry.

Implementations

impl CacheStatsHandler

pub const fn new(capacity: usize) -> Self

Creates a new stats handler with all counters initialized to zero.

pub fn collisions(&self) -> u64

Returns the number of cache collisions.

pub fn size(&self) -> usize

Returns the current size (number of entries).

pub const fn capacity(&self) -> usize

Returns the capacity (maximum number of entries).

pub fn increment_size(&self)

Increments the size counter. Called on cache insert.

pub fn decrement_size(&self)

Decrements the size counter. Called on cache remove.

pub fn reset_size(&self)

Resets size to zero. Called on cache clear.

pub fn reset_stats(&self)

Resets collision counter to zero (but not size).

Trait Implementations

impl Debug for CacheStatsHandler

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

Formats the value using the given formatter.

impl<K: PartialEq, V> StatsHandler<K, V> for CacheStatsHandler

fn on_hit(&self, _key: &K, _value: &V)

Called when a cache hit occurs (key found and value returned).

fn on_miss(&self, _key: AnyRef<'_>)

Called when a cache miss occurs (key not found).

fn on_insert(&self, key: &K, _value: &V, evicted: Option<(&K, &V)>)

Called when a key is inserted.

fn on_remove(&self, _key: &K, _value: &V)

Called when a key is removed from the cache.

fn on_collision( &self, new_key: AnyRef<'_>, existing_key: &K, existing_value: &V, )

👎Deprecated:

use on_insert and check that evicted key doesn’t equal to new key

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 24 bytes