Struct cushy::value::Owned

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

A unique, reactive value.

This type is useful for situations where a value is owned by exactly one type but needs to have reactivity through Source/Destination.

A Dynamic utilizes a Arc + [Mutex] to support updating its values from multiple threads. This type utilizes a RefCell, preventing it from being shared between multiple threads.

Implementations

impl<T> Owned<T>

pub fn new(value: T) -> Self

Returns a new reactive value.

pub fn borrow(&self) -> OwnedRef<'_, T>

Borrows the contents of this value with read-only access.

pub fn borrow_mut(&mut self) -> OwnedMut<'_, T>

Borrows the contents of this value with exclusive access.

When the returned type is accessed through DerefMut, all associated reactive callbacks will be invoked upon dropping the returned OwnedMut.

pub fn into_inner(self) -> T

Returns the contained value.

Trait Implementations

impl<T: Default> Default for Owned<T>

fn default() -> Owned<T>

Returns the “default value” for a type.

impl<'de, T> Deserialize<'de> for Owned<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 Owned<T>

where T: 'static,

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

Maps the contents with exclusive access. Before returning from this function, all observers will be notified that the contents have been updated.

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

Maps the contents with exclusive access. Before returning from this function, all observers will be notified that the contents have been updated.

impl<T> From<Owned<T>> for ReadOnly<T>

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

Converts to this type from the input type.

impl<T> IntoReadOnly<T> for Owned<T>

fn into_read_only(self) -> ReadOnly<T>

Returns self as a ReadOnly.

impl<T> Serialize for Owned<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 Owned<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 for_each_subsequent_generational_try<F>(&self, for_each: F) -> CallbackHandle

where T: Send + 'static, F: for<'a> FnMut(DynamicGuard<'a, 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_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 try_map_ref<R>(&self, map: impl FnOnce(&T) -> R) -> Result<R, DeadlockError>

Maps the contents with read-only access.