Struct StaticMut 

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

Like StaticCell but provides &mut T access through UnsafeCell.

Used for types that need mutable access from a single owner thread (e.g., DspEngine from audio ISR, IrManager from loader thread).

Safety contract

• init() and shutdown() must be called single-threaded (lifecycle guarantee).
• get_mut() requires the caller to ensure exclusive access.

Implementations

impl<T> StaticMut<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.

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 unsafe fn get_mut(&self) -> &mut T

Get a mutable reference to the contained value.

Safety

Caller must ensure exclusive access (single-threaded or external synchronization).

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

Try to get an immutable reference, returning None if not initialized.

pub fn get(&self) -> &T

Get an immutable reference to the contained value.

Panics

Panics if the cell has not been initialized.

pub fn shutdown(&self)

Drop the contained value and mark the cell as uninitialized.

Idempotent — no-op if already empty.

Trait Implementations

impl<T> Deref for StaticMut<T>

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &T

Dereferences the value.

impl<T: Send> Send for StaticMut<T>

impl<T: Send> Sync for StaticMut<T>