Struct Dynamic

pub struct Dynamic<T>(/* private fields */);

An instance of a value that provides APIs to observe and react to its contents.

Implementations

impl<T> Dynamic<T>

pub fn new(value: T) -> Self

Creates a new instance wrapping value.

pub fn downgrade(&self) -> WeakDynamic<T>

Returns a weak reference to this dynamic.

This is powered by Arc/Weak and follows the same semantics for reference counting.

pub fn instances(&self) -> usize

Returns the number Dynamics that point to this same value.

The returned count includes self.

Panics

This function panics if this value is already locked by the current thread.

pub fn readers(&self) -> usize

Returns the number of DynamicReaders for this value.

Panics

This function panics if this value is already locked by the current thread.

pub fn linked<R, TIntoR, TIntoRResult, RIntoT, RIntoTResult>( &self, t_into_r: TIntoR, r_into_t: RIntoT, ) -> Dynamic<R>

where T: PartialEq + Send + 'static, R: PartialEq + Send + 'static, TIntoRResult: Into<Option<R>> + Send + 'static, RIntoTResult: Into<Option<T>> + Send + 'static, TIntoR: FnMut(&T) -> TIntoRResult + Send + 'static, RIntoT: FnMut(&R) -> RIntoTResult + Send + 'static,

Returns a new dynamic that has its contents linked with self by the pair of mapping functions provided.

When the returned dynamic is updated, r_into_t will be invoked. This function accepts &R and can return T, or Option<T>. If a value is produced, self will be updated with the new value.

When self is updated, t_into_r will be invoked. This function accepts &T and can return R or Option<R>. If a value is produced, the returned dynamic will be updated with the new value.

Panics

This function panics if calling t_into_r with the current contents of the Dynamic produces a None value. This requirement is only for the first invocation, and it is guaranteed to occur before this function returns.

pub fn linked_string(&self) -> Dynamic<String>

where T: ToString + FromStr + PartialEq + Send + 'static,

Creates a linked dynamic containing a String.

When self is updated, ToString::to_string() will be called to produce a new string value to store in the returned dynamic.

When the returned dynamic is updated, str::parse is called to produce a new T. If an error is returned, self will not be updated. Otherwise, self will be updated with the produced value.

pub fn linked_accessor<U, Getter, Setter>( &self, get: Getter, get_mut: Setter, ) -> Dynamic<U>

where T: Send + 'static, U: PartialEq + Clone + Send + 'static, Getter: Fn(&T) -> &U + Send + Clone + 'static, Setter: Fn(&mut T) -> &mut U + Send + 'static,

Returns a dynamic that is synchronized with a borrowed value from self.

When the returned dynamic is updated, self will be updated using get_mut.

pub fn set_source(&self, source: CallbackHandle)

Sets the current source for this dynamic with source.

A dynamic can have multiple source callbacks.

This ensures that source stays active as long as any clones of self are alive.

pub fn with_for_each<F>(self, for_each: F) -> Self

where T: Send + 'static, F: for<'a> FnMut(&'a T) + Send + 'static,

Attaches for_each to this value so that it is invoked each time the value’s contents are updated. This function returns self.

pub fn with_clone<R>(&self, with_clone: impl FnOnce(Self) -> R) -> R

A helper function that invokes with_clone with a clone of self. This code may produce slightly more readable code.

use cushy::reactive::value::{Dynamic, Source};

let value = Dynamic::new(1);

// Using with_clone
value.with_clone(|value| {
    std::thread::spawn(move || {
        println!("{}", value.get());
    })
});

// Using an explicit clone
std::thread::spawn({
    let value = value.clone();
    move || {
        println!("{}", value.get());
    }
});

println!("{}", value.get());

pub fn create_reader(&self) -> DynamicReader<T>

Returns a new reference-based reader for this dynamic value.

Panics

This function panics if this value is already locked by the current thread.

pub fn into_reader(self) -> DynamicReader<T>

Converts this Dynamic into a reader.

Panics

This function panics if this value is already locked by the current thread.

pub fn lock(&self) -> DynamicGuard<'_, T>

Returns an exclusive reference to the contents of this dynamic.

This call will block until all other guards for this dynamic have been dropped.

Panics

This function panics if this value is already locked by the current thread.

pub fn try_lock(&self) -> Result<DynamicGuard<'_, T>, DeadlockError>

Returns an exclusive reference to the contents of this dynamic.

This call will block until all other guards for this dynamic have been dropped.

Errors

Returns an error if the current thread already holds a lock to this dynamic.

pub fn transition_to(&self, new_value: T) -> DynamicTransition<T>

where T: LinearInterpolate + Clone + Send + Sync,

Returns a pending transition for this value to new_value.

pub fn new_radio(&self, widget_value: T) -> Radio<T>

where Self: Clone, T: Clone + PartialEq,

Returns a new Radio that updates this dynamic to widget_value when pressed.

pub fn new_checkbox(&self) -> Checkbox

where Self: IntoDynamic<CheckboxState>,

Returns a new checkbox that updates self when clicked.

pub fn new_select(&self, widget_value: T, label: impl MakeWidget) -> Select<T>

where Self: Clone, T: Clone + PartialEq,

Returns a new Select that updates this dynamic to widget_value when pressed. label is drawn next to the checkbox and is also clickable to select the widget.

pub fn validate_with<E, Valid>(&self, check: Valid) -> Dynamic<Validation>

where T: Send + 'static, Valid: for<'a> FnMut(&'a T) -> Result<(), E> + Send + 'static, E: Display,

Validates the contents of this dynamic using the check function, returning a dynamic that contains the validation status.

impl Dynamic<WidgetInstance>

pub fn into_switcher(self) -> Switcher

Returns a new Switcher widget whose contents is the value of this dynamic.

pub fn to_switcher(&self) -> Switcher

Returns a new Switcher widget whose contents is the value of this dynamic.

impl Dynamic<WidgetList>

pub fn into_rows(self) -> Stack

Returns self as a vertical Stack of rows.

pub fn to_rows(&self) -> Stack

Returns self as a vertical Stack of rows.

pub fn into_columns(self) -> Stack

Returns self as a horizontal Stack of columns.

pub fn to_columns(&self) -> Stack

Returns self as a horizontal Stack of columns.

pub fn into_layers(self) -> Layers

Returns self as Layers, with the widgets being stacked in the Z direction.

pub fn to_layers(&self) -> Layers

Returns self as Layers, with the widgets being stacked in the Z direction.

pub fn into_list(self) -> List

Returns self as an unordered List.

pub fn to_list(self) -> List

Returns self as an unordered List.

pub fn into_wrap(self) -> Wrap

Returns a Wrap that lays the children out horizontally, wrapping into additional rows as needed.

pub fn to_wrap(&self) -> Wrap

Returns a Wrap that lays the children out horizontally, wrapping into additional rows as needed.

Trait Implementations

impl<T> Clone for Dynamic<T>

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T> Debug for Dynamic<T>

where T: Debug,

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

Formats the value using the given formatter.

impl<T> Default for Dynamic<T>

where T: Default,

fn default() -> Self

Returns the “default value” for a type.

impl<'de, T> Deserialize<'de> for Dynamic<T>

where T: Deserialize<'de>,

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<T> Destination<T> for Dynamic<T>

fn try_map_mut<R>( &self, map: impl FnOnce(Mutable<'_, T>) -> R, ) -> Result<R, DeadlockError>

Maps the contents with exclusive access. All observers will be notified at some point in the future if the value has been changed.

fn map_mut<R>(&self, map: impl FnOnce(Mutable<'_, T>) -> R) -> R

Maps the contents with exclusive access. All observers will be notified at some point in the future if the value has been changed.

fn try_replace(&self, new_value: T) -> Result<T, ReplaceError<T>>

where T: PartialEq,

Replaces the contents with new_value if new_value is different than the currently stored value. If the value is updated, the previous contents are returned.

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

where T: PartialEq,

Replaces the contents with new_value, returning the previous contents. All observers will be notified at some point in the future if the value has been changed.

fn set(&self, new_value: T)

where T: PartialEq,

Stores new_value in this dynamic. All observers will be notified at some point in the future if the value has been changed.

fn force_set(&self, new_value: T)

Stores new_value in this dynamic without checking for equality.

fn try_compare_swap( &self, expected_current: &T, new_value: T, ) -> Result<T, TryCompareSwapError<T>>

where T: Clone + PartialEq,

Replaces the current value with new_value if the current value is equal to expected_current.

fn compare_swap(&self, expected_current: &T, new_value: T) -> Result<T, T>

where T: Clone + PartialEq,

Replaces the current value with new_value if the current value is equal to expected_current.

fn toggle(&self) -> T

where T: Not<Output = T> + Clone,

Updates the value to the result of invoking Not on the current value. This function returns the new value.

fn take(&self) -> T

where Self: Source<T>, T: Default,

Returns the currently stored value, replacing the current contents with T::default().

fn take_if_not_default(&self) -> Option<T>

where T: Default + PartialEq,

Checks if the currently stored value is different than T::default(), and if so, returns Some(self.take()).

impl<T> Displayable<T> for Dynamic<T>

where T: Debug + Display + Send + 'static,

fn into_displayable(self) -> DynamicReader<T>

Returns this value as a displayable reader.

fn into_label(self) -> Label<T>

where Self: Sized, T: Debug + Display + Send + 'static,

Returns self being Displayed in a Label widget.

fn to_label(&self) -> Label<T>

where Self: Clone,

Returns self being Displayed in a Label widget.

impl<T> Drop for Dynamic<T>

fn drop(&mut self)

Executes the destructor for this type.

impl<T> DynamicRead<T> for Dynamic<T>

fn read(&self) -> DynamicGuard<'_, T, true>

Returns a guard that provides exclusive, read-only access to the value contained wihtin this dynamic.

fn read_nonblocking( &self, ) -> Result<DynamicGuard<'_, T, true>, TryLockError<'_>>

Attempts to obtain a guard that provides exclusive, read-only access to the value contained wihtin this dynamic.

impl<'a, T> From<&'a Dynamic<T>> for WeakDynamic<T>

fn from(value: &'a Dynamic<T>) -> Self

Converts to this type from the input type.

impl From<&str> for Dynamic<String>

fn from(value: &str) -> Self

Converts to this type from the input type.

impl<T> From<Dynamic<T>> for DynamicReader<T>

fn from(value: Dynamic<T>) -> Self

Converts to this type from the input type.

impl<T> From<Dynamic<T>> for Notify<T>

fn from(value: Dynamic<T>) -> Self

Converts to this type from the input type.

impl<T> From<Dynamic<T>> for ReadOnly<T>

fn from(value: Dynamic<T>) -> Self

Converts to this type from the input type.

impl<T> From<Dynamic<T>> for SharedNotify<T>

fn from(value: Dynamic<T>) -> Self

Converts to this type from the input type.

impl<T> From<Dynamic<T>> for Tracked<Dynamic<T>>

where T: Clone + PartialEq,

fn from(source: Dynamic<T>) -> Self

Converts to this type from the input type.

impl<T> From<Dynamic<T>> for Value<T>

fn from(value: Dynamic<T>) -> Self

Converts to this type from the input type.

impl<T> From<Dynamic<T>> for WeakDynamic<T>

fn from(value: Dynamic<T>) -> Self

Converts to this type from the input type.

impl From<String> for Dynamic<String>

fn from(value: String) -> Self

Converts to this type from the input type.

impl<T> IntoComponentValue for Dynamic<T>

where T: Clone + Send + 'static, Component: From<T>,

fn into_component_value(self) -> Value<Component>

Returns self stored in a component value.

impl IntoDynamic<CheckboxState> for Dynamic<Option<bool>>

fn into_dynamic(self) -> Dynamic<CheckboxState>

Returns self as a dynamic.

impl IntoDynamic<CheckboxState> for Dynamic<bool>

fn into_dynamic(self) -> Dynamic<CheckboxState>

Returns self as a dynamic.

impl<T> IntoDynamic<T> for Dynamic<T>

fn into_dynamic(self) -> Dynamic<T>

Returns self as a dynamic.

impl<T, E> IntoDynamic<Validation> for Dynamic<Result<T, E>>

where T: Send + 'static, E: Display + Send + 'static,

fn into_dynamic(self) -> Dynamic<Validation>

Returns self as a dynamic.

impl<T> IntoDynamicComponentValue for Dynamic<T>

where T: ComponentDefinition + Clone + Send + Sync + 'static,

fn into_dynamic_component(self) -> Value<DynamicComponent>

Returns this type converted into a dynamic component value.

impl<T> IntoReadOnly<T> for Dynamic<T>

fn into_read_only(self) -> ReadOnly<T>

Returns self as a ReadOnly.

impl<T> IntoReader<T> for Dynamic<T>

fn into_reader(self) -> DynamicReader<T>

Returns this value as a reader.

impl IntoValue<ContainerShadow> for Dynamic<ContainerShadow<Lp>>

fn into_value(self) -> Value<ContainerShadow>

Returns this type as a Value.

impl IntoValue<ContainerShadow> for Dynamic<ContainerShadow<Px>>

fn into_value(self) -> Value<ContainerShadow>

Returns this type as a Value.

impl IntoValue<CowString> for Dynamic<&'static str>

fn into_value(self) -> Value<CowString>

Returns this type as a Value.

impl IntoValue<CowString> for Dynamic<String>

fn into_value(self) -> Value<CowString>

Returns this type as a Value.

impl IntoValue<FluentValue<'static>> for &Dynamic<&'static str>

fn into_value(self) -> Value<FluentValue<'static>>

Returns this type as a Value.

impl IntoValue<FluentValue<'static>> for &Dynamic<String>

fn into_value(self) -> Value<FluentValue<'static>>

Returns this type as a Value.

impl IntoValue<FluentValue<'static>> for &Dynamic<f32>

fn into_value(self) -> Value<FluentValue<'static>>

Returns this type as a Value.

impl IntoValue<FluentValue<'static>> for &Dynamic<f64>

fn into_value(self) -> Value<FluentValue<'static>>

Returns this type as a Value.

impl IntoValue<FluentValue<'static>> for &Dynamic<i128>

fn into_value(self) -> Value<FluentValue<'static>>

Returns this type as a Value.

impl IntoValue<FluentValue<'static>> for &Dynamic<i16>

fn into_value(self) -> Value<FluentValue<'static>>

Returns this type as a Value.

impl IntoValue<FluentValue<'static>> for &Dynamic<i32>

fn into_value(self) -> Value<FluentValue<'static>>

Returns this type as a Value.

impl IntoValue<FluentValue<'static>> for &Dynamic<i64>

fn into_value(self) -> Value<FluentValue<'static>>

Returns this type as a Value.

impl IntoValue<FluentValue<'static>> for &Dynamic<i8>

fn into_value(self) -> Value<FluentValue<'static>>

Returns this type as a Value.

impl IntoValue<FluentValue<'static>> for &Dynamic<isize>

fn into_value(self) -> Value<FluentValue<'static>>

Returns this type as a Value.

impl IntoValue<FluentValue<'static>> for &Dynamic<u128>

fn into_value(self) -> Value<FluentValue<'static>>

Returns this type as a Value.

impl IntoValue<FluentValue<'static>> for &Dynamic<u16>

fn into_value(self) -> Value<FluentValue<'static>>

Returns this type as a Value.

impl IntoValue<FluentValue<'static>> for &Dynamic<u32>

fn into_value(self) -> Value<FluentValue<'static>>

Returns this type as a Value.

impl IntoValue<FluentValue<'static>> for &Dynamic<u64>

fn into_value(self) -> Value<FluentValue<'static>>

Returns this type as a Value.

impl IntoValue<FluentValue<'static>> for &Dynamic<u8>

fn into_value(self) -> Value<FluentValue<'static>>

Returns this type as a Value.

impl IntoValue<FluentValue<'static>> for &Dynamic<usize>

fn into_value(self) -> Value<FluentValue<'static>>

Returns this type as a Value.

impl IntoValue<FluentValue<'static>> for Dynamic<&'static str>

fn into_value(self) -> Value<FluentValue<'static>>

Returns this type as a Value.

impl IntoValue<FluentValue<'static>> for Dynamic<String>

fn into_value(self) -> Value<FluentValue<'static>>

Returns this type as a Value.

impl IntoValue<FluentValue<'static>> for Dynamic<f32>

fn into_value(self) -> Value<FluentValue<'static>>

Returns this type as a Value.

impl IntoValue<FluentValue<'static>> for Dynamic<f64>

fn into_value(self) -> Value<FluentValue<'static>>

Returns this type as a Value.

impl IntoValue<FluentValue<'static>> for Dynamic<i128>

fn into_value(self) -> Value<FluentValue<'static>>

Returns this type as a Value.

impl IntoValue<FluentValue<'static>> for Dynamic<i16>

fn into_value(self) -> Value<FluentValue<'static>>

Returns this type as a Value.

impl IntoValue<FluentValue<'static>> for Dynamic<i32>

fn into_value(self) -> Value<FluentValue<'static>>

Returns this type as a Value.

impl IntoValue<FluentValue<'static>> for Dynamic<i64>

fn into_value(self) -> Value<FluentValue<'static>>

Returns this type as a Value.

impl IntoValue<FluentValue<'static>> for Dynamic<i8>

fn into_value(self) -> Value<FluentValue<'static>>

Returns this type as a Value.

impl IntoValue<FluentValue<'static>> for Dynamic<isize>

fn into_value(self) -> Value<FluentValue<'static>>

Returns this type as a Value.

impl IntoValue<FluentValue<'static>> for Dynamic<u128>

fn into_value(self) -> Value<FluentValue<'static>>

Returns this type as a Value.

impl IntoValue<FluentValue<'static>> for Dynamic<u16>

fn into_value(self) -> Value<FluentValue<'static>>

Returns this type as a Value.

impl IntoValue<FluentValue<'static>> for Dynamic<u32>

fn into_value(self) -> Value<FluentValue<'static>>

Returns this type as a Value.

impl IntoValue<FluentValue<'static>> for Dynamic<u64>

fn into_value(self) -> Value<FluentValue<'static>>

Returns this type as a Value.

impl IntoValue<FluentValue<'static>> for Dynamic<u8>

fn into_value(self) -> Value<FluentValue<'static>>

Returns this type as a Value.

impl IntoValue<FluentValue<'static>> for Dynamic<usize>

fn into_value(self) -> Value<FluentValue<'static>>

Returns this type as a Value.

impl IntoValue<MaskedString> for Dynamic<&'static str>

fn into_value(self) -> Value<MaskedString>

Returns this type as a Value.

impl IntoValue<MaskedString> for Dynamic<String>

fn into_value(self) -> Value<MaskedString>

Returns this type as a Value.

impl<T> IntoValue<T> for &Dynamic<T>

fn into_value(self) -> Value<T>

Returns this type as a Value.

impl<T> IntoValue<T> for Dynamic<T>

fn into_value(self) -> Value<T>

Returns this type as a Value.

impl IntoWidgetList for Dynamic<WidgetList>

fn into_widget_list(self) -> Value<WidgetList>

Returns this list of widgets as a Value<WidgetList>.

fn into_rows(self) -> Stack

Returns self as a vertical Stack of rows.

fn into_columns(self) -> Stack

Returns self as a horizontal Stack of columns.

fn into_layers(self) -> Layers

Returns self as Layers, with the widgets being stacked in the Z direction.

fn into_wrap(self) -> Wrap

Returns a Wrap that lays the children out horizontally, wrapping into additional rows as needed.

fn into_list(self) -> List

Returns self as an unordered List.

impl MakeWidgetWithTag for Dynamic<&'static str>

fn make_with_tag(self, id: WidgetTag) -> WidgetInstance

Returns a new WidgetInstance whose WidgetId comes from tag.

impl MakeWidgetWithTag for Dynamic<Option<WidgetInstance>>

fn make_with_tag(self, id: WidgetTag) -> WidgetInstance

Returns a new WidgetInstance whose WidgetId comes from tag.

impl MakeWidgetWithTag for Dynamic<String>

fn make_with_tag(self, id: WidgetTag) -> WidgetInstance

Returns a new WidgetInstance whose WidgetId comes from tag.

impl MakeWidgetWithTag for Dynamic<WidgetInstance>

fn make_with_tag(self, id: WidgetTag) -> WidgetInstance

Returns a new WidgetInstance whose WidgetId comes from tag.

impl<T> PartialEq<Dynamic<T>> for WeakDynamic<T>

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl<T> PartialEq<WeakDynamic<T>> for Dynamic<T>

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl<T> PartialEq for Dynamic<T>

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

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

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

impl<T> Serialize for Dynamic<T>

where T: Serialize,

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl<T> Source<T> for Dynamic<T>

fn try_map_generational<R>( &self, map: impl FnOnce(DynamicGuard<'_, T, true>) -> R, ) -> Result<R, DeadlockError>

Maps the contents with read-only access, providing access to the value’s Generation.

fn on_change_try<F>(&self, on_change: F) -> CallbackHandle

where T: Send + 'static, F: FnMut() -> Result<(), CallbackDisconnected> + Send + 'static,

Executes on_change when the contents of this dynamic are updated.

fn for_each_subsequent_generational_try<F>(&self, for_each: F) -> CallbackHandle

where T: Send + 'static, F: for<'a> FnMut(DynamicGuard<'_, T, true>) -> Result<(), CallbackDisconnected> + Send + 'static,

Attaches for_each to this value so that it is invoked each time the source’s contents are updated.

fn for_each_subsequent_generational_cloned_try<F>( &self, for_each: F, ) -> CallbackHandle

where T: Clone + Send + 'static, F: FnMut(GenerationalValue<T>) -> Result<(), CallbackDisconnected> + Send + 'static,

Invokes for_each with the current contents and each time this source’s contents are updated.

fn map_generational<R>( &self, map: impl FnOnce(DynamicGuard<'_, T, true>) -> R, ) -> R

Maps the contents with read-only access, providing access to the value’s Generation.

fn generation(&self) -> Generation

Returns the current generation of the value.

fn map_ref<R>(&self, map: impl FnOnce(&T) -> R) -> R

Maps the contents with read-only access.

fn get(&self) -> T

where T: Clone,

Returns a clone of the currently contained value.

fn try_map_ref<R>(&self, map: impl FnOnce(&T) -> R) -> Result<R, DeadlockError>

Maps the contents with read-only access.

fn try_get(&self) -> Result<T, DeadlockError>

where T: Clone,

Returns a clone of the currently contained value.

fn get_tracking_redraw(&self, context: &WidgetContext<'_>) -> T

where T: Clone, Self: Trackable + Sized,

Returns a clone of the currently contained value.

fn get_tracking_invalidate(&self, context: &WidgetContext<'_>) -> T

where T: Clone, Self: Trackable + Sized,

Returns a clone of the currently contained value.

fn on_change<F>(&self, on_change: F) -> CallbackHandle

where T: Send + 'static, F: FnMut() + Send + 'static,

Executes on_change when the contents of this dynamic are updated.

fn for_each_subsequent_generational<F>(&self, for_each: F) -> CallbackHandle

where T: Send + 'static, F: for<'a> FnMut(DynamicGuard<'_, T, true>) + Send + 'static,

Attaches for_each to this value so that it is invoked each time the source’s contents are updated.

fn for_each_subsequent_try<F>(&self, for_each: F) -> CallbackHandle

where T: Send + 'static, F: for<'a> FnMut(&'a T) -> Result<(), CallbackDisconnected> + Send + 'static,

Attaches for_each to this value so that it is invoked each time the source’s contents are updated.

fn for_each_subsequent<F>(&self, for_each: F) -> CallbackHandle

where T: Send + 'static, F: for<'a> FnMut(&'a T) + Send + 'static,

Attaches for_each to this value so that it is invoked each time the source’s contents are updated.

fn for_each_generational_try<F>(&self, for_each: F) -> CallbackHandle

where T: Send + 'static, F: for<'a> FnMut(DynamicGuard<'_, T, true>) -> Result<(), CallbackDisconnected> + Send + 'static,

Invokes for_each with the current contents and each time this source’s contents are updated.

fn for_each_generational<F>(&self, for_each: F) -> CallbackHandle

where T: Send + 'static, F: for<'a> FnMut(DynamicGuard<'_, T, true>) + Send + 'static,

Invokes for_each with the current contents and each time this source’s contents are updated.

fn for_each_try<F>(&self, for_each: F) -> CallbackHandle

where T: Send + 'static, F: for<'a> FnMut(&'a T) -> Result<(), CallbackDisconnected> + Send + 'static,

Invokes for_each with the current contents and each time this source’s contents are updated.

fn for_each<F>(&self, for_each: F) -> CallbackHandle

where T: Send + 'static, F: for<'a> FnMut(&'a T) + Send + 'static,

Invokes for_each with the current contents and each time this source’s contents are updated.

fn for_each_generational_cloned_try<F>(&self, for_each: F) -> CallbackHandle

where T: Clone + Send + 'static, F: FnMut(GenerationalValue<T>) -> Result<(), CallbackDisconnected> + Send + 'static,

Invokes for_each with the current contents and each time this source’s contents are updated.

fn for_each_cloned_try<F>(&self, for_each: F) -> CallbackHandle

where T: Clone + Send + 'static, F: FnMut(T) -> Result<(), CallbackDisconnected> + Send + 'static,

Invokes for_each with the current contents and each time this source’s contents are updated.

fn for_each_subsequent_cloned_try<F>(&self, for_each: F) -> CallbackHandle

where T: Clone + Send + 'static, F: FnMut(T) -> Result<(), CallbackDisconnected> + Send + 'static,

Invokes for_each each time this source’s contents are updated.

fn for_each_subsequent_cloned<F>(&self, for_each: F) -> CallbackHandle

where T: Clone + Send + 'static, F: FnMut(T) + Send + 'static,

Invokes for_each each time this source’s contents are updated.

fn for_each_cloned<F>(&self, for_each: F) -> CallbackHandle

where T: Clone + Send + 'static, F: FnMut(T) + Send + 'static,

Invokes for_each with the current contents and each time this source’s contents are updated.

fn for_each_notify(&self, notify: impl Into<Notify<T>>) -> CallbackHandle

where T: Unpin + Clone + Send + 'static,

Notifies notify with a clone of the current contents each time this source’s contents are updated.

fn for_each_try_notify(&self, notify: impl Into<Notify<T>>) -> CallbackHandle

where T: Unpin + Clone + Send + 'static,

Notifies notify with a clone of the current contents each time this source’s contents are updated, disconnecting the callback if the target is disconnected.

fn debounced_every(&self, period: Duration) -> Dynamic<T>

where T: PartialEq + Clone + Send + Sync + 'static,

Returns a new dynamic that contains the updated contents of this dynamic at most once every period.

fn debounced_with_delay(&self, period: Duration) -> Dynamic<T>

where T: PartialEq + Clone + Send + Sync + 'static,

Returns a new dynamic that contains the updated contents of this dynamic delayed by period. Each time this value is updated, the delay is reset.

fn map_each_generational<R, F>(&self, map: F) -> Dynamic<R>

where T: Send + 'static, F: for<'a> FnMut(DynamicGuard<'a, T, true>) -> R + Send + 'static, R: PartialEq + Send + 'static,

Creates a new dynamic value that contains the result of invoking map each time this value is changed.

fn map_each<R, F>(&self, map: F) -> Dynamic<R>

where T: Send + 'static, F: for<'a> FnMut(&'a T) -> R + Send + 'static, R: PartialEq + Send + 'static,

Creates a new dynamic value that contains the result of invoking map each time this value is changed.

fn map_each_cloned<R, F>(&self, map: F) -> Dynamic<R>

where T: Clone + Send + 'static, F: FnMut(T) -> R + Send + 'static, R: PartialEq + Send + 'static,

Creates a new dynamic value that contains the result of invoking map each time this value is changed.

fn weak_clone(&self) -> Dynamic<T>

where T: Clone + Send + 'static,

Returns a new Dynamic that contains a clone of each value from self.

fn map_each_into<U>(&self) -> Dynamic<U>

where U: PartialEq + From<T> + Send + 'static, T: Clone + Send + 'static,

Returns a new dynamic that is updated using U::from(T.clone()) each time self is updated.

fn map_each_to<U>(&self) -> Dynamic<U>

where U: PartialEq + for<'a> From<&'a T> + Send + 'static, T: Clone + Send + 'static,

Returns a new dynamic that is updated using U::from(&T) each time self is updated.

impl<'s, T, U> Unwrapped<U> for &'s Dynamic<T>

where for<'a> &'a T: IntoOption<&'a U>, T: Send + 'static, U: Clone + Send + 'static,

type Value<'a> = &'a U

The value type provided to the for each functions.

fn unwrapped_or_else(self, initial: impl FnOnce() -> U) -> Dynamic<U>

Returns a dynamic that is updated with the unwrapped contents of thie source.

fn for_each_unwrapped_try<ForEach>(self, for_each: ForEach) -> CallbackHandle

where ForEach: for<'a> FnMut(Self::Value<'a>) -> Result<(), CallbackDisconnected> + Send + 'static,

Invokes for_each when self is updated with a value that can be unwrapped.

fn unwrapped(self) -> Dynamic<T>

where T: Default,

Returns a dynamic that is updated with the unwrapped contents of thie source.

fn for_each_unwrapped<ForEach>(self, for_each: ForEach) -> CallbackHandle

where ForEach: for<'a> FnMut(Self::Value<'a>) + Send + 'static,

Invokes for_each when self is updated with a value that can be unwrapped.

impl<T> Eq for Dynamic<T>

impl<T> TrackedSource for Dynamic<T>

where T: Clone + PartialEq,