Struct MappedSignal

pub struct MappedSignal<O: ?Sized + 'static, S: AnyStorage = UnsyncStorage> { /* private fields */ }

A read only signal that has been mapped to a new type.

Trait Implementations

impl<O: ?Sized, S: AnyStorage> Clone for MappedSignal<O, S>

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 + 'static, S: AnyStorage> Debug for MappedSignal<T, S>

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

Formats the value using the given formatter.

impl<O, S> Deref for MappedSignal<O, S>

where O: Clone, S: AnyStorage + 'static,

Allow calling a signal with signal() syntax

Currently only limited to copy types, though could probably specialize for string/arc/rc

type Target = dyn Fn() -> O

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<T: Display + 'static, S: AnyStorage> Display for MappedSignal<T, S>

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

Formats the value using the given formatter.

impl<O, S> IntoAttributeValue for MappedSignal<O, S>

where O: Clone + IntoAttributeValue, S: AnyStorage,

fn into_value(self) -> AttributeValue

Convert into an attribute value

impl<T: PartialEq + 'static, S: AnyStorage> PartialEq<T> for MappedSignal<T, S>

fn eq(&self, other: &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<O, S> PartialEq for MappedSignal<O, S>

where O: ?Sized, S: AnyStorage,

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<O, S> Readable for MappedSignal<O, S>

where O: ?Sized, S: AnyStorage,

type Target = O

The target type of the reference.

type Storage = S

The type of the storage this readable uses.

fn try_read_unchecked(&self) -> Result<ReadableRef<'static, Self>, BorrowError>

Try to get a reference to the value without checking the lifetime. This will subscribe the current scope to the signal.

fn try_peek_unchecked(&self) -> BorrowResult<ReadableRef<'static, Self>>

Try to peek the current value of the signal without subscribing to updates. If the value has been dropped, this will return an error.

fn map<O>( self, f: impl Fn(&Self::Target) -> &O + 'static, ) -> MappedSignal<O, Self::Storage>

where Self: Clone + Sized + 'static,

Map the readable type to a new type. This lets you provide a view into a readable type without needing to clone the inner value.

fn read(&self) -> ReadableRef<'_, Self>

Get the current value of the state. If this is a signal, this will subscribe the current scope to the signal. If the value has been dropped, this will panic. Calling this on a Signal is the same as using the signal() syntax to read and subscribe to its value

fn try_read(&self) -> Result<ReadableRef<'_, Self>, BorrowError>

Try to get the current value of the state. If this is a signal, this will subscribe the current scope to the signal.

fn read_unchecked(&self) -> ReadableRef<'static, Self>

Get a reference to the value without checking the lifetime. This will subscribe the current scope to the signal.

fn peek(&self) -> ReadableRef<'_, Self>

Get the current value of the state without subscribing to updates. If the value has been dropped, this will panic.

fn try_peek(&self) -> Result<ReadableRef<'_, Self>, BorrowError>

Try to peek the current value of the signal without subscribing to updates. If the value has been dropped, this will return an error.

fn peek_unchecked(&self) -> ReadableRef<'static, Self>

Get the current value of the signal without checking the lifetime. Unlike read, this will not subscribe the current scope to the signal which can cause parts of your UI to not update.

fn cloned(&self) -> Self::Target

where Self::Target: Clone,

Clone the inner value and return it. If the value has been dropped, this will panic.

fn with<O>(&self, f: impl FnOnce(&Self::Target) -> O) -> O

Run a function with a reference to the value. If the value has been dropped, this will panic.

fn with_peek<O>(&self, f: impl FnOnce(&Self::Target) -> O) -> O

Run a function with a reference to the value. If the value has been dropped, this will panic.

fn index<I>( &self, index: I, ) -> ReadableRef<'_, Self, <Self::Target as Index<I>>::Output>

where Self::Target: Index<I>,

Index into the inner value and return a reference to the result. If the value has been dropped or the index is invalid, this will panic.