Struct State 

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

A mutable value that notifies the observers that read it. Cloning a State clones the handle, not the value: all clones share one value.

Implementations

impl<T: 'static> State<T>

pub fn new(value: T) -> Self

Creates a state holding value.

pub fn get(&self) -> T

where T: Clone,

Returns a clone of the value and records the read.

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

Reads the value by reference and records the read.

pub fn peek(&self) -> Ref<'_, T>

Borrows the value without recording a dependency.

pub fn set(&self, value: T)

Replaces the value and notifies dependents.

pub fn set_if_changed(&self, value: T)

where T: PartialEq,

Replaces the value only if it differs, notifying only on change.

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

Mutates the value in place and notifies dependents.

pub fn binding(&self) -> Binding<T>

where T: Clone,

A read/write view of this state for child components.

Trait Implementations

impl<T> Clone for State<T>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for State<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<T: Default + 'static> Default for State<T>

fn default() -> Self

Returns the “default value” for a type.