Struct Buffer 

pub struct Buffer<T> {
    pub capacity: usize,
    pub values: Vec<T>,
}

A bounded FIFO connective.

Fields

capacity: usize

Maximum number of retained values.

values: Vec<T>

Retained values in FIFO order.

Implementations

impl<T> Buffer<T>

pub fn new(capacity: usize) -> Self

Construct an empty FIFO with a fixed capacity.

pub fn capacity(&self) -> usize

Fixed FIFO capacity.

pub fn len(&self) -> usize

Number of retained values.

pub fn is_empty(&self) -> bool

Whether no values are retained.

pub fn is_full(&self) -> bool

Whether the FIFO is at capacity.

pub fn push(&mut self, value: T) -> Result<(), T>

Push one value, returning it unchanged when the FIFO is full.

Errors

Returns the supplied value when the buffer is full.

pub fn pop(&mut self) -> Option<T>

Remove and return the oldest retained value.

impl<T: ValueEq + Copy> Buffer<T>

pub fn contains(&self, value: T) -> bool

Query retained membership through the Buffer owner.

pub fn push_unique(&mut self, value: T) -> bool

Append a value only when it is absent and capacity remains.

pub fn remove_value(&mut self, value: T) -> bool

Remove one distinct retained value wherever it occurs.

Trait Implementations

impl<T: Debug> Debug for Buffer<T>

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

Formats the value using the given formatter.