Struct OnceFlag 

pub struct OnceFlag { /* private fields */ }

A flag for tracking one-time logging

Use this with Logger::*_once() or Logger::*_skip_first() methods to control conditional logging. The flag should be declared as a static to ensure it persists across calls.

Example

use nros_core::{Logger, OnceFlag};

static LOGGED: OnceFlag = OnceFlag::new();
let logger = Logger::new("my_node");

// Only the first call will actually log
for _ in 0..10 {
    logger.info_once(&LOGGED, "This only logs once");
}

Implementations

impl OnceFlag

pub const fn new() -> Self

Create a new once flag (not yet triggered)

pub fn check_first(&self) -> bool

Check if this is the first time being called, and mark as triggered

Returns true on the first call, false on subsequent calls.

Uses load+store instead of compare_exchange for compatibility with targets lacking CAS (e.g., riscv32imc without the A extension). This is safe for nros’s single-core embedded use cases.

pub fn is_triggered(&self) -> bool

Check if the flag has been triggered

pub fn reset(&self)

Reset the flag to untriggered state

Trait Implementations

impl Debug for OnceFlag

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

Formats the value using the given formatter.

impl Default for OnceFlag

fn default() -> Self

Returns the “default value” for a type.

impl Send for OnceFlag

impl Sync for OnceFlag