Struct LogRing 

pub struct LogRing { /* private fields */ }

The last lines of a log, oldest first, and how many older ones were dropped. Each line pushed gets a sequence number, from 0 and never reused, so a reader takes the lines since the last it took.

Implementations

impl LogRing

pub fn new(capacity: usize) -> Self

An empty ring that keeps capacity lines.

pub fn push(&mut self, line: LogLine)

Keeps line, dropping (and counting) the oldest when full.

pub fn lines(&self) -> Iter<'_, LogLine>

The kept lines, oldest first.

pub fn dropped(&self) -> u32

How many lines were dropped to keep the newest.

pub fn add_dropped(&mut self, n: u32)

Counts n more lines dropped (elsewhere, before they got here).

pub fn next_seq(&self) -> u64

The sequence number the next line pushed gets.

pub fn since(&self, seq: u64) -> Iter<'_, LogLine>

The kept lines whose sequence number is seq or more, oldest first: those after the last a reader took, if it kept next_seq then.

pub fn take(&mut self) -> (Vec<LogLine>, u32)

Takes every kept line and the dropped count, leaving the ring empty with none dropped. Sequence numbers go on from where they were.

Trait Implementations

impl Clone for LogRing

fn clone(&self) -> LogRing

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LogRing

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

Formats the value using the given formatter.

impl Eq for LogRing

impl PartialEq for LogRing

fn eq(&self, other: &LogRing) -> bool

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for LogRing