Struct LogBuffer 

pub struct LogBuffer<T: AsRef<[u8]> + AsMut<[u8]>> { /* private fields */ }

A ring buffer that stores UTF-8 text.

Anything that implements AsMut<[u8]> can be used for backing storage; e.g. [u8; N], Vec<[u8]>, Box<[u8]>.

Implementations

impl<T: AsRef<[u8]> + AsMut<[u8]>> LogBuffer<T>

pub fn new(storage: T) -> LogBuffer<T>

Creates a new ring buffer, backed by storage.

The buffer is cleared after creation.

pub fn clear(&mut self)

Clears the buffer.

Only the text written after clearing will be read out by a future extraction.

This function takes O(n) time where n is buffer length.

pub fn is_empty(&self) -> bool

Checks whether the ring buffer is empty.

This function takes O(1) time.

pub fn extract(&mut self) -> &str

Extracts the contents of the ring buffer as a string slice, excluding any partially overwritten UTF-8 code unit sequences at the beginning.

Extraction rotates the contents of the ring buffer such that all of its contents becomes contiguous in memory.

This function takes O(n) time where n is buffer length.

pub fn extract_lines(&mut self) -> Lines<'_>

Extracts the contents of the ring buffer as an iterator over its lines, excluding any partially overwritten lines at the beginning.

The first line written to the ring buffer after clearing it should start with '\n', or it will be treated as partially overwritten and lost.

Extraction rotates the contents of the ring buffer such that all of its contents becomes contiguous in memory.

This function takes O(n) time where n is buffer length.

Trait Implementations

impl<T: Debug + AsRef<[u8]> + AsMut<[u8]>> Debug for LogBuffer<T>

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

Formats the value using the given formatter.

impl<T: AsRef<[u8]> + AsMut<[u8]>> Write for LogBuffer<T>

fn write_str(&mut self, s: &str) -> Result

Append s to the ring buffer.

This function takes O(n) time where n is length of s.

fn write_char(&mut self, c: char) -> Result<(), Error>

Writes a char into this writer, returning whether the write succeeded.

fn write_fmt(&mut self, args: Arguments<'_>) -> Result<(), Error>

Glue for usage of the write! macro with implementors of this trait.