Struct NegCache 

pub struct NegCache { /* private fields */ }

Thread-safe negative result cache.

Keys are (query_fingerprint, content_hash) pairs. When a file is verified and produces zero matches, it is recorded here so subsequent queries for the same pattern can skip re-reading the file if its content hasn’t changed.

Implementations

impl NegCache

pub fn new(max_entries: usize) -> Self

Create a negative cache with the given maximum entry count.

pub fn set_admit(&self, allow: bool)

Set whether new entries are admitted.

When false, record_negative returns immediately without caching. Lookups still work on existing entries.

Panics

Panics if the internal RwLock is poisoned.

pub fn is_known_negative( &self, query_fingerprint: u64, content_hash: u64, ) -> bool

Panics

Panics if the internal RwLock is poisoned.

pub fn record_negative(&self, query_fingerprint: u64, content_hash: u64)

Panics

Panics if the internal RwLock is poisoned.

pub fn invalidate_file(&self, content_hash: u64)

Panics

Panics if the internal RwLock is poisoned.

pub fn invalidate_query(&self, query_fingerprint: u64)

Panics

Panics if the internal RwLock is poisoned.

pub fn clear(&self)

Panics

Panics if the internal RwLock is poisoned.

pub fn evict_fraction(&self, fraction: f64)

Evict a fraction of entries (e.g., 0.5 evicts half). Used by adaptive cache policy under memory pressure.

Panics

Panics if the internal RwLock is poisoned.

pub fn stats(&self) -> NegCacheStats

Panics

Panics if the internal RwLock is poisoned.

pub fn len(&self) -> usize

Panics

Panics if the internal RwLock is poisoned.

pub fn is_empty(&self) -> bool

Panics

Panics if the internal RwLock is poisoned.

Trait Implementations

impl Debug for NegCache

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

Formats the value using the given formatter.