Struct ResidentIfdsCsrCache 

pub struct ResidentIfdsCsrCache<R> { /* private fields */ }

Backend-resident IFDS CSR cache keyed by normalized prepared layout.

Implementations

impl<R> ResidentIfdsCsrCache<R>

where R: Clone,

pub fn new() -> Self

Create an empty resident IFDS CSR cache.

pub fn with_max_retained_bytes(max_retained_bytes: usize) -> Self

Create a cache with a soft upper bound on retained resident graph bytes.

The newest entry is always retained so one oversized graph may exceed the limit; older entries are evicted before uploading a cache miss.

pub fn get_or_upload<D>( &mut self, dispatch: &D, prepared: &PreparedIfdsCsr, ) -> Result<&ResidentPreparedIfdsCsr<R>, String>

where D: IfdsResidentDispatch<Resource = R>,

Return a resident IFDS CSR for prepared, uploading on cache miss.

pub fn len(&self) -> usize

Number of resident IFDS CSR entries retained by the cache.

pub fn is_empty(&self) -> bool

Whether the cache is empty.

pub fn stats(&self) -> ResidentIfdsCsrCacheStats

Return point-in-time cache counters.

pub fn resident_identities(&self) -> Vec<ResidentGraphCacheIdentity>

Deterministic cache identity snapshot for diagnostics and release evidence.

pub fn miss_reason_for_identity( &self, requested: &ResidentGraphCacheIdentity, ) -> ResidentGraphCacheMissReason

Explain why requested would miss the current resident IFDS cache.

pub const fn last_miss_reason(&self) -> Option<ResidentGraphCacheMissReason>

Reason attached to the most recent cache miss. Hits clear this field.

pub fn free_all<D>(&mut self, dispatch: &D) -> Result<(), String>

where D: IfdsResidentDispatch<Resource = R>,

Free every resident IFDS CSR owned by this cache.

Trait Implementations

impl<R> Default for ResidentIfdsCsrCache<R>

fn default() -> Self

Returns the “default value” for a type.