Struct StaticCell 

pub struct StaticCell<T> { /* private fields */ }

A no_std init-once container designed for the oveRTOS lifecycle.

• const fn new() — usable in static declarations
• init() — set value (panics if already set)
• get() — get reference (panics if not set)
• try_get() — non-panicking variant
• shutdown() — drop contained value, mark uninitialized

Safety contract

init() and shutdown() must be called single-threaded (framework lifecycle guarantee: on_init / on_shutdown). Between init and shutdown the value is immutable — no data race is possible.

Implementations

impl<T> StaticCell<T>

pub const fn new() -> Self

Create an empty cell. Usable in static declarations.

pub fn init(&self, val: T)

Initialize the cell with val.

Panics

Panics if the cell is already initialized.

Safety contract

Must be called single-threaded (e.g. in on_init).

pub fn get(&self) -> &T

Get a reference to the contained value.

Panics

Panics if the cell has not been initialized.

pub fn try_init(&self, val: T) -> Result<(), T>

Try to initialize the cell. Returns Err(val) if already initialized, so the caller doesn’t lose the value.

Safety contract

Same as init() — must be called single-threaded.

pub fn try_get(&self) -> Option<&T>

Try to get a reference, returning None if not initialized.

pub fn shutdown(&self)

Drop the contained value and mark the cell as uninitialized.

Idempotent — no-op if already empty.

Safety contract

Must be called single-threaded (e.g. in on_shutdown).

Trait Implementations

impl<T> Deref for StaticCell<T>

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &T

Dereferences the value.

impl<T: Send> Send for StaticCell<T>

impl<T: Send + Sync> Sync for StaticCell<T>