Struct Signal 

pub struct Signal<T: 'static>(/* private fields */);

Implementations

impl<T> Signal<T>

pub fn new(value: T) -> Self

pub fn id(&self) -> usize

pub fn get(&self) -> T

where T: Clone,

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

Read the current value without cloning it, tracking the read in the reactive graph. Prefer over get for large/expensive-to-clone types.

pub fn set_neq(&self, v: T)

where T: PartialEq + Clone,

Set the signal value only if it changed, skipping subscribers, the reactive graph, and the frame request when the value is unchanged.

pub fn set(&self, v: T)

where T: Clone,

Set the signal value and notify subscribers + the reactive graph. Always notifies, even if the value is equal - prefer set_neq for UI state where equality is cheap. Subscribers observe a snapshot clone, so re-entrant set/update inside a subscriber cannot alias the reference they hold.

pub fn update<F: FnOnce(&mut T)>(&self, f: F)

where T: Clone,

pub fn subscribe(&self, f: impl Fn(&T) + 'static) -> SubId

pub fn unsubscribe(&self, id: SubId) -> bool

Remove a subscriber by id. Returns true if removed.

pub fn subscribe_guard(&self, f: impl Fn(&T) + 'static) -> SubGuard<T>

Subscribe and get a guard that auto-unsubscribes on drop.

Trait Implementations

impl<T> Clone for Signal<T>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.