Struct MaterializedKeys 

pub struct MaterializedKeys<K>
where
    K: Ord + Clone,
{ /* private fields */ }

Tracks which keys are materialized (and which are pending an upquery).

Implementations

impl<K> MaterializedKeys<K>

where K: Ord + Clone,

pub const fn new() -> Self

Creates an empty tracker.

pub fn status(&self, key: &K) -> KeyStatus

Reports a key’s status without mutating the tracker.

pub fn lookup(&mut self, key: K) -> LookupOutcome<K>

Probes the tracker for key. Missing keys are transitioned to pending and an Upquery outcome is returned so the caller can dispatch the upquery.

pub fn mark_materialized(&mut self, key: K) -> usize

Marks key as fully materialized. Returns the number of waiters that had been blocked on the upquery (so callers can wake them).

pub fn mark_many_materialized<I>(&mut self, keys: I) -> usize

where I: IntoIterator<Item = K>,

Bulk-marks several keys as materialized; returns total waiter count.

pub fn forget(&mut self, key: &K) -> bool

Drops key from the materialized set (for example, after eviction).

pub fn fail_pending(&mut self, key: &K) -> usize

Aborts a pending upquery for key, transitioning it back to Missing.

pub const fn materialized(&self) -> &BTreeSet<K>

Returns the materialized key set.

pub const fn pending(&self) -> &BTreeSet<K>

Returns the pending key set.

pub fn materialized_len(&self) -> usize

Returns the number of materialized keys.

pub fn pending_len(&self) -> usize

Returns the number of pending keys.

pub fn is_empty(&self) -> bool

Returns true when nothing is materialized or pending.

impl<K> MaterializedKeys<K>

where K: Ord + Clone,

pub fn lookup_batch<I>(&mut self, keys: I) -> BatchLookup<K>

where I: IntoIterator<Item = K>,

Probes a batch of keys, splitting them into hit / upquery / pending sets.

Trait Implementations

impl<K> Clone for MaterializedKeys<K>

where K: Ord + Clone + Clone,

fn clone(&self) -> MaterializedKeys<K>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<K> Debug for MaterializedKeys<K>

where K: Ord + Clone + Debug,

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

Formats the value using the given formatter.

impl<K> Default for MaterializedKeys<K>

where K: Ord + Clone,

fn default() -> Self

Returns the “default value” for a type.

impl<K> Eq for MaterializedKeys<K>

where K: Ord + Clone + Eq,

impl<K> PartialEq for MaterializedKeys<K>

where K: Ord + Clone + PartialEq,

fn eq(&self, other: &MaterializedKeys<K>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<K> StructuralPartialEq for MaterializedKeys<K>

where K: Ord + Clone,