Struct DataSeries 

pub struct DataSeries<T: Clone> { /* private fields */ }

A fixed-capacity ring buffer that holds a sliding window of data items.

When the buffer is full, pushing a new item overwrites the oldest entry. Items are always presented in chronological order (oldest first).

Implementations

impl<T: Clone> DataSeries<T>

pub fn new(capacity: usize) -> Self

Creates a new empty DataSeries with the given capacity.

Panics

Panics if capacity is zero.

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

Pushes an item into the ring buffer in O(1) time.

If the buffer is already at capacity the oldest item is overwritten.

pub fn len(&self) -> usize

Returns the number of items currently stored.

pub fn is_empty(&self) -> bool

Returns true if the buffer contains no items.

pub fn capacity(&self) -> usize

Returns the maximum capacity of the buffer.

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

Returns a reference to the item at index where 0 is the oldest item.

Returns None if index is out of bounds.

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

Returns an iterator that yields references from oldest to newest.

pub fn as_slice(&self) -> Vec<T>

Returns all items as a Vec<T> ordered oldest-first.

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

Returns a reference to the newest (most recently pushed) item.

pub fn clear(&mut self)

Removes all items, resetting the buffer to empty.

Trait Implementations

impl<T: Clone + Clone> Clone for DataSeries<T>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug + Clone> Debug for DataSeries<T>

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

Formats the value using the given formatter.