Struct PostingCache 

pub struct PostingCache { /* private fields */ }

Thread-safe, memory-bounded LRU cache mapping Trigram → PostingList.

Uses FIFO eviction (oldest first) when the memory_ceiling is exceeded. Admission can be toggled via set_admit for adaptive cache policy integration.

Implementations

impl PostingCache

pub fn new(memory_ceiling: usize) -> Self

Create a cache with the given byte budget (0 = reject all inserts).

pub fn set_admit(&self, allow: bool)

Set whether new entries are admitted.

When false, insert returns immediately without caching. Existing entries are retained (not evicted) — call invalidate_all to flush.

Panics

Panics if the internal RwLock is poisoned.

pub fn get(&self, trigram: Trigram) -> Option<PostingList>

Panics

Panics if the internal RwLock is poisoned.

pub fn insert(&self, trigram: Trigram, list: PostingList)

Panics

Panics if the internal RwLock is poisoned.

pub fn invalidate(&self, trigram: Trigram)

Panics

Panics if the internal RwLock is poisoned.

pub fn invalidate_all(&self)

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.

pub fn stats(&self) -> CacheStats

Panics

Panics if the internal RwLock is poisoned.

pub fn memory_used(&self) -> usize

Panics

Panics if the internal RwLock is poisoned.

Trait Implementations

impl Debug for PostingCache

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

Formats the value using the given formatter.

impl Default for PostingCache

fn default() -> Self

Returns the “default value” for a type.