Struct OnceLite 

pub struct OnceLite(/* private fields */);

A lightweight call_once primitive.

This structure provides the Rust equivalent of the kernel’s DO_ONCE_LITE macro. While it would be possible to implement the feature entirely as a Rust macro, the functionality that can be implemented as regular functions has been extracted and implemented as the OnceLite struct for better code maintainability.

Implementations

impl OnceLite

pub const fn new() -> Self

Creates a new OnceLite in the incomplete state.

pub fn call_once<F>(&self, f: F) -> bool

where F: FnOnce(),

Calls the provided function exactly once.

There is no other synchronization between two call_once()s except that only one will execute f, in other words, callers should not use a failed call_once() as a proof that another call_once() has already finished and the effect is observable to this thread.