Struct LocalState 

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

A cloneable handle to typed, process-local application state.

Clones refer to the same value. Mutations advance an internal revision so bound widgets can skip formatting work when nothing changed.

Implementations

impl<T> LocalState<T>

pub fn new(value: T) -> LocalState<T>

pub fn with<R>(&self, read: impl FnOnce(&T) -> R) -> R

Read the current value without exposing the backing lock.

pub fn set(&self, value: T)

Replace the value and invalidate widgets bound to this handle.

At revision exhaustion this is a no-op. Use Self::try_set when the caller needs to observe that failure.

pub fn try_set(&self, value: T) -> bool

As Self::set, reporting whether the replacement was published. Returns false when the captured owner is closed or the revision namespace is exhausted. The value is then left untouched, so a bound widget cannot mistake a new value for one it already observed under a wrapped revision.

pub fn update(&self, update: impl FnOnce(&mut T))

Mutate the value and invalidate widgets bound to this handle once. At revision exhaustion this is a no-op. Use Self::try_update when the caller needs to observe that failure.

pub fn try_update(&self, update: impl FnOnce(&mut T)) -> bool

As Self::update, reporting whether update ran. Returns false when the captured owner is closed or at revision exhaustion, without invoking update.

pub fn revision(&self) -> u64

Monotonic local edit revision for correlating asynchronous receipts.

pub fn writer(&self) -> LocalStateWriter<T>

where T: Send + Sync + 'static,

Create a thread-safe writer that wakes this state’s captured owner after mutation.

The owner is captured once by LocalState::new, so writers requested under another app keep the original destination. State created outside a wake scope is permanently detached. Live apps should construct state and roots inside an App factory or explicit scope.

impl<T> LocalState<T>

where T: Clone,

pub fn get(&self) -> T

impl LocalState<String>

pub fn text_sink(&self) -> impl FnMut(&str) + 'static

A directly usable TextInput callback.

This keeps the common input-to-local-state path allocation and closure boilerplate out of application code.

Trait Implementations

impl<T> Clone for LocalState<T>

fn clone(&self) -> LocalState<T>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.