Struct LogicalCache 

pub struct LogicalCache<K, V> { /* private fields */ }

A bounded logical cache charged to a ByteBudget.

Implementations

impl<K, V> LogicalCache<K, V>

where K: Eq + Hash + Clone,

pub fn new(budget: ByteBudget) -> Result<Self, ResourceError>

Build a cache charged to budget. A zero-limit budget makes every insert a no-op (the cache is effectively disabled).

Errors

Returns ResourceError if the initial zero-byte reservation cannot be created (only when the budget is already over its limit).

pub fn limit(&self) -> usize

Configured byte limit for this cache.

pub fn get(&mut self, key: &K) -> Option<&V>

Look up key, marking it most-recently-used on a hit.

pub fn insert(&mut self, key: K, value: V, bytes: usize) -> bool

Insert or replace an entry whose retained size is bytes. Evicts LRU entries until it fits; a value larger than the whole budget is not cached. Returns whether the entry is now resident.

pub fn retain(&mut self, keep: impl FnMut(&K, &V) -> bool) -> usize

Drop every entry keep rejects, releasing its bytes (counted as evictions). Returns how many entries were dropped.

pub fn clear(&mut self)

Drop every entry, releasing all charged bytes.

pub fn stats(&self) -> CacheStats

Occupancy and counters.