Struct LocalItem 

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

A scope-local item.

Implementations

impl<T: Send + Sync + 'static> LocalItem<T>

pub fn with<R>(&self, operation: impl for<'access> FnOnce(&'access T) -> R) -> R

Runs operation with the value selected by the active scope.

The higher-ranked closure prevents a reference into per-CPU-selected storage from escaping after preemption is re-enabled. The first global access initializes the global scope before entering the pinned access. Concurrent first access waits for that initialization to be published.

pub fn with_pinned<R>( &self, pin: &CpuPin<'_>, operation: impl for<'access> FnOnce(&'access T) -> R, ) -> R

Runs operation under an existing CPU pin without initialization.

Panics

Panics if the selected global scope has not been initialized by LocalItem::with. Explicit Scope values are initialized eagerly.

pub fn try_with_pinned<R>( &self, pin: &CpuPin<'_>, operation: impl for<'access> FnOnce(&'access T) -> R, ) -> Option<R>

Runs operation without lazy initialization under an existing pin.

This returns None when the selected global scope has not yet been initialized, allowing hard-IRQ callers to avoid allocation.

pub fn clone_current(&self) -> T

where T: Clone,

Clones the selected value while keeping the CPU pin lifetime short.

pub fn scope<'scope>(&self, scope: &'scope Scope) -> ScopeItem<'scope, T>

Returns a reference to this item within the given scope.

pub fn scope_mut<'scope>( &self, scope: &'scope mut Scope, ) -> ScopeItemMut<'scope, T>

Returns a mutable reference to this item within the given scope.