Struct leptos::WriteSignal

pub struct WriteSignal<T>where
    T: 'static,{ /* private fields */ }

The setter for a reactive signal.

A signal is a piece of data that may change over time, and notifies other code when it has changed. This is the core primitive of Leptos’s reactive system.

Calling WriteSignal::update will mutate the signal’s value in place, and notify all subscribers that the signal’s value has changed.

WriteSignal implements Fn, such that set_value(new_value) is equivalent to set_value.update(|value| *value = new_value).

WriteSignal is Copy and 'static, so it can very easily moved into closures or copied structs.

Core Trait Implementations

• .set() (or calling the setter as a function) sets the signal’s value, and notifies all subscribers that the signal’s value has changed. to subscribe to the signal, and to re-run whenever the value of the signal changes.
  • .set_untracked() sets the signal’s value without notifying its subscribers.
• .update() mutates the signal’s value in place and notifies all subscribers that the signal’s value has changed.
  • .update_untracked() mutates the signal’s value in place without notifying its subscribers.

Examples

let (count, set_count) = create_signal(cx, 0);

// ✅ calling the setter sets the value
set_count(1);
assert_eq!(count(), 1);

// ❌ don't try to call the getter within the setter
// set_count(count() + 1);

// ✅ instead, use .update() to mutate the value in place
set_count.update(|count: &mut i32| *count += 1);
assert_eq!(count(), 2);

Trait Implementations

impl<T> Clone for WriteSignal<T>

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T> Debug for WriteSignal<T>where T: Debug + 'static,

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

Formats the value using the given formatter.

impl<T> From<WriteSignal<T>> for SignalSetter<T>

fn from(value: WriteSignal<T>) -> SignalSetter<T>

Converts to this type from the input type.

impl<T> Hash for WriteSignal<T>where T: Hash + 'static,

fn hash<__H>(&self, state: &mut __H)where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<T> PartialEq<WriteSignal<T>> for WriteSignal<T>where T: PartialEq<T> + 'static,

fn eq(&self, other: &WriteSignal<T>) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<T> SignalDispose for WriteSignal<T>

fn dispose(self)

Disposes of the signal. This:

impl<T> SignalSet<T> for WriteSignal<T>

Examples

let (count, set_count) = create_signal(cx, 0);

// notifies subscribers
set_count.update(|n| *n = 1); // it's easier just to call set_count(1), though!
assert_eq!(count(), 1);

// you can include arbitrary logic in this update function
// also notifies subscribers, even though the value hasn't changed
set_count.update(|n| if *n > 3 { *n += 1 });
assert_eq!(count(), 1);

fn set(&self, new_value: T)

Sets the signal’s value and notifies subscribers.

fn try_set(&self, new_value: T) -> Option<T>

Sets the signal’s value and notifies subscribers. Returns None if the signal is still valid, [Some(T)] otherwise.

impl<T> SignalSetUntracked<T> for WriteSignal<T>where T: 'static,

fn set_untracked(&self, new_value: T)

Sets the signal’s value without notifying dependents.

fn try_set_untracked(&self, new_value: T) -> Option<T>

Attempts to set the signal if it’s still valid. Returns None if the signal was set, [Some(T)] otherwise.

impl<T> SignalUpdate<T> for WriteSignal<T>

Examples

let (count, set_count) = create_signal(cx, 0);

// notifies subscribers
set_count.update(|n| *n = 1); // it's easier just to call set_count(1), though!
assert_eq!(count(), 1);

// you can include arbitrary logic in this update function
// also notifies subscribers, even though the value hasn't changed
set_count.update(|n| if *n > 3 { *n += 1 });
assert_eq!(count(), 1);

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

Applies a function to the current value to mutate it in place and notifies subscribers that the signal has changed.

fn try_update<O>(&self, f: impl FnOnce(&mut T) -> O) -> Option<O>

Applies a function to the current value to mutate it in place and notifies subscribers that the signal has changed. Returns [Some(O)] if the signal is still valid, None otherwise.

fn update_returning<O>(&self, f: impl FnOnce(&mut T) -> O) -> Option<O>

👎Deprecated: Please use try_update instead. This method will be removed in a future version of this crate

Applies a function to the current value to mutate it in place and notifies subscribers that the signal has changed. Returns [Some(O)] if the signal is still valid, None otherwise.

impl<T> SignalUpdateUntracked<T> for WriteSignal<T>

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

Runs the provided closure with a mutable reference to the current value without notifying dependents.

fn update_returning_untracked<U>( &self, f: impl FnOnce(&mut T) -> U ) -> Option<U>

👎Deprecated: Please use try_update_untracked instead. This method will be removed in a future version of leptos

Runs the provided closure with a mutable reference to the current value without notifying dependents and returns the value the closure returned.

fn try_update_untracked<O>(&self, f: impl FnOnce(&mut T) -> O) -> Option<O>

Runs the provided closure with a mutable reference to the current value without notifying dependents and returns the value the closure returned.

impl<T> Copy for WriteSignal<T>

impl<T> Eq for WriteSignal<T>where T: Eq + 'static,

impl<T> StructuralEq for WriteSignal<T>where T: 'static,

impl<T> StructuralPartialEq for WriteSignal<T>where T: 'static,