Struct LogRing 

pub struct LogRing<T> { /* private fields */ }

Circular buffer for log storage with FIFO eviction.

Memory-efficient storage that maintains a sliding window of the most recent items. Older items are evicted when capacity is reached.

Implementations

impl<T> LogRing<T>

pub fn new(capacity: usize) -> Self

Create a new LogRing with the specified capacity.

Panics

Panics if capacity is 0.

pub fn push(&mut self, item: T)

Add an item to the ring.

If the ring is at capacity, the oldest item is evicted first.

pub fn extend(&mut self, items: impl IntoIterator<Item = T>)

Add multiple items efficiently.

pub fn get(&self, absolute_idx: usize) -> Option<&T>

Get item by absolute index (across entire history).

Returns None if the index is out of range or the item has been evicted.

pub fn get_mut(&mut self, absolute_idx: usize) -> Option<&mut T>

Get mutable reference by absolute index.

pub fn get_range(&self, range: Range<usize>) -> impl Iterator<Item = &T>

Get a range of items by absolute indices.

Returns references to items that are still in memory within the range. Items that have been evicted are skipped.

pub const fn total_count(&self) -> usize

Total items ever added (including evicted).

pub fn len(&self) -> usize

Number of items currently in memory.

pub fn is_empty(&self) -> bool

Check if the ring is empty.

pub const fn capacity(&self) -> usize

Maximum capacity of the ring.

pub fn first_index(&self) -> usize

First absolute index still in memory.

pub fn last_index(&self) -> Option<usize>

Last absolute index (most recent item).

Returns None if the ring is empty.

pub fn is_in_memory(&self, absolute_idx: usize) -> bool

Check if an absolute index is still in memory.

pub fn evicted_count(&self) -> usize

Number of items that have been evicted.

pub fn clear(&mut self)

Clear all items.

Note: total_count is preserved for consistency with absolute indexing.

pub fn reset(&mut self)

Clear all items and reset counters.

pub fn back(&self) -> Option<&T>

Get the most recent item.

pub fn front(&self) -> Option<&T>

Get the oldest item still in memory.

pub fn iter(&self) -> impl DoubleEndedIterator<Item = &T>

Iterate over items currently in memory (oldest to newest).

pub fn iter_indexed(&self) -> impl DoubleEndedIterator<Item = (usize, &T)>

Iterate over items with their absolute indices.

pub fn drain(&mut self) -> impl Iterator<Item = T> + '_

Drain all items from the ring.

Trait Implementations

impl<T: Clone> Clone for LogRing<T>

fn clone(&self) -> LogRing<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for LogRing<T>

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

Formats the value using the given formatter.

impl<T> Default for LogRing<T>

fn default() -> Self

Returns the “default value” for a type.

impl<T> Extend<T> for LogRing<T>

fn extend<I: IntoIterator<Item = T>>(&mut self, iter: I)

Extends a collection with the contents of an iterator.

fn extend_one(&mut self, item: A)

🔬This is a nightly-only experimental API. (extend_one)

Extends a collection with exactly one element.

fn extend_reserve(&mut self, additional: usize)

🔬This is a nightly-only experimental API. (extend_one)

Reserves capacity in a collection for the given number of additional elements.

impl<T> FromIterator<T> for LogRing<T>

fn from_iter<I: IntoIterator<Item = T>>(iter: I) -> Self

Creates a value from an iterator.