Struct LoggerStatic 

pub struct LoggerStatic<const CAP: usize, const MSG_LEN: usize> { /* private fields */ }

🪵 Fixed-capacity static logger with owned byte buffers.

---

^{📍 sys/log}

---

Each logger is identified by its capacity (CAP) as the number of stored messages, and each message’s maximum length (MSG_LEN).

Use the slog! macro to define, log, clear, or iterate its messages.

Safety

Employs a single-byte, non-atomic guard as a const-safe soft check against re-entrant or concurrent access.

While not providing full thread safety, it can detect most accidental overlaps in single-threaded or unsynchronized contexts, serving as a last-resort diagnostic aid under the assumption of disciplined single-threaded use.

Implementations

impl<const CAP: usize, const MSG_LEN: usize> LoggerStatic<CAP, MSG_LEN>

pub const fn new() -> Self

Constructs a new static logger.

pub const fn clear(&mut self)

Clears all the stored messages.

pub const fn count(&mut self) -> usize

Returns the number of logged messages.

pub const fn is_full(&mut self) -> bool

Whether the logger is full.

pub const fn log_bytes(&mut self, msg: &[u8])

Logs bytes from msg, truncating if longer than MSG_LEN.

pub const fn get(&mut self, i: usize) -> Option<(&str, usize)>

Returns the message and truncation count at index i, or None if out of bounds.

Features

Uses the unsafe_str feature to skip duplicated UTF-8 validation.

pub fn for_each<F: FnMut(usize, &str, usize)>(&mut self, f: F)

Runs the provided closure for each message in run-time.

The closure receives:

• i: index of the message
• s: string slice (truncated if necessary)
• truncated: number of bytes that did not fit

Features

Uses the unsafe_str feature to skip duplicated validation checks.

pub const fn any_truncated(&mut self) -> bool

Returns true if any logged message was truncated.

pub const fn truncation_stats(&mut self) -> (usize, usize)

Returns (count, total_lost_bytes) for truncated messages.

Trait Implementations

impl<const CAP: usize, const MSG_LEN: usize> Clone for LoggerStatic<CAP, MSG_LEN>

fn clone(&self) -> LoggerStatic<CAP, MSG_LEN>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<const CAP: usize, const MSG_LEN: usize> Debug for LoggerStatic<CAP, MSG_LEN>

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

Formats the value using the given formatter.

impl<const CAP: usize, const MSG_LEN: usize> Default for LoggerStatic<CAP, MSG_LEN>

fn default() -> Self

Returns the “default value” for a type.

impl<const CAP: usize, const MSG_LEN: usize> Eq for LoggerStatic<CAP, MSG_LEN>

impl<const CAP: usize, const MSG_LEN: usize> Hash for LoggerStatic<CAP, MSG_LEN>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<const CAP: usize, const MSG_LEN: usize> PartialEq for LoggerStatic<CAP, MSG_LEN>

fn eq(&self, other: &LoggerStatic<CAP, MSG_LEN>) -> bool

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<const CAP: usize, const MSG_LEN: usize> StructuralPartialEq for LoggerStatic<CAP, MSG_LEN>