Struct HistoryCache 

pub struct HistoryCache { /* private fields */ }

Geordnete Sample-Ablage.

Interner Storage: BTreeMap fuer O(log n) Insert/Lookup und effizienten Range-Iterator.

**** die schreibenden Methoden brauchen weiter &mut self (BTreeMap ist nicht concurrent-safe), aber Stats sind in einem Arc<HistoryCacheStats> parallel verfuegbar — siehe stats.

Implementations

impl HistoryCache

pub fn new_with_kind(kind: HistoryKind, max_samples: usize) -> Self

Erzeugt einen neuen Cache. max_samples ist die obere Grenze: bei KeepAll fuehrt Ueberschreitung zu CapacityExceeded, bei KeepLast zu LRU-Eviction des aeltesten Samples.

pub fn stats(&self) -> Arc<HistoryCacheStats>

Geteilter Stats-Handle fuer lock-freies Monitoring.

Konsumenten halten einen Arc<HistoryCacheStats> und pollen die Atomics mit Acquire-Ordering. Werte spiegeln immer eine abgeschlossene Cache-Mutation; cross-field-Konsistenz zwischen len und max_sn ist nicht garantiert (Tear-Risiko).

pub fn new(max_samples: usize) -> Self

Legacy-Konstruktor — erzeugt einen KeepAll-Cache mit harter Kapazitaets-Grenze. Fuer neue Nutzer [new_with_kind] bevorzugen.

pub fn kind(&self) -> HistoryKind

History-Kind dieses Caches.

pub fn evicted_count(&self) -> u64

Anzahl per KeepLast-Eviction verworfener Samples seit Start.

pub fn insert(&mut self, change: CacheChange) -> Result<(), CacheError>

Fuegt ein Change ein.

Errors

• CapacityExceeded: nur bei KeepAll, Cache voll.
• DuplicateSequenceNumber: SN bereits vorhanden.
• ZeroDepth: KeepLast { depth: 0 }.

pub fn get(&self, sn: SequenceNumber) -> Option<&CacheChange>

Holt ein Change per SN.

pub fn remove_up_to(&mut self, sn: SequenceNumber) -> usize

Entfernt alle Changes mit SN ≤ sn. Liefert die Anzahl entfernter Eintraege.

pub fn iter_range( &self, lo: SequenceNumber, hi: SequenceNumber, ) -> impl Iterator<Item = &CacheChange> + '_

Iteriert in SN-Reihenfolge ueber Changes im Bereich [lo, hi] (beide inklusiv).

pub fn min_sn(&self) -> Option<SequenceNumber>

Kleinste SN im Cache.

pub fn max_sn(&self) -> Option<SequenceNumber>

Groesste SN im Cache.

pub fn len(&self) -> usize

Anzahl Changes.

pub fn is_empty(&self) -> bool

True wenn keine Changes.

pub fn capacity(&self) -> usize

Maximale Kapazitaet.

Trait Implementations

impl Clone for HistoryCache

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HistoryCache

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

Formats the value using the given formatter.