Struct dioxus_signals::CopyValue

pub struct CopyValue<T: 'static> { /* private fields */ }

CopyValue is a wrapper around a value to make the value mutable and Copy.

It is internally backed by generational_box::GenerationalBox.

Implementations

impl<T: 'static> CopyValue<T>

pub fn new(value: T) -> Self

Create a new CopyValue. The value will be stored in the current component.

Once the component this value is created in is dropped, the value will be dropped.

pub fn new_in_scope(value: T, scope: ScopeId) -> Self

Create a new CopyValue. The value will be stored in the given scope. When the specified scope is dropped, the value will be dropped.

pub fn origin_scope(&self) -> ScopeId

Get the scope this value was created in.

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

Try to read the value. If the value has been dropped, this will return None.

pub fn read(&self) -> Ref<'static, T>

Read the value. If the value has been dropped, this will panic.

pub fn try_write(&self) -> Option<RefMut<'static, T>>

Try to write the value. If the value has been dropped, this will return None.

pub fn write(&self) -> RefMut<'static, T>

Write the value. If the value has been dropped, this will panic.

pub fn set(&mut self, value: T)

Set the value. If the value has been dropped, this will panic.

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

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

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

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

impl<T: Clone + 'static> CopyValue<T>

pub fn value(&self) -> T

Get the value. If the value has been dropped, this will panic.

impl<T: 'static> CopyValue<Vec<T>>

pub fn get(&self, index: usize) -> Option<Ref<'_, T>>

Read a value from the inner vector.

impl<T: 'static> CopyValue<Option<T>>

pub fn unwrap(&self) -> Twhere T: Clone,

Unwraps the inner value and clones it.

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

Attemps to read the inner value of the Option.

impl<T: 'static> CopyValue<Vec<T>>

pub fn push(&self, value: T)

Pushes a new value to the end of the vector.

pub fn pop(&self) -> Option<T>

Pops the last value from the vector.

pub fn insert(&self, index: usize, value: T)

Inserts a new value at the given index.

pub fn remove(&self, index: usize) -> T

Removes the value at the given index.

pub fn clear(&self)

Clears the vector, removing all values.

pub fn extend(&self, iter: impl IntoIterator<Item = T>)

Extends the vector with the given iterator.

pub fn truncate(&self, len: usize)

Truncates the vector to the given length.

pub fn swap_remove(&self, index: usize) -> T

Swaps two values in the vector.

pub fn retain(&self, f: impl FnMut(&T) -> bool)

Retains only the values that match the given predicate.

pub fn split_off(&self, at: usize) -> Vec<T>

Splits the vector into two at the given index.

impl<T: 'static> CopyValue<Option<T>>

pub fn take(&self) -> Option<T>

Takes the value out of the Option.

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

Replace the value in the Option.

pub fn get_or_insert(&self, default: T) -> Ref<'_, T>

Gets the value out of the Option, or inserts the given value if the Option is empty.

pub fn get_or_insert_with(&self, default: impl FnOnce() -> T) -> Ref<'_, T>

Gets the value out of the Option, or inserts the value returned by the given function if the Option is empty.

impl<T: 'static> CopyValue<Vec<T>>

pub fn get_mut(&self, index: usize) -> Option<RefMut<'_, T>>

Write to an element in the inner vector.

impl<T: 'static> CopyValue<Option<T>>

pub fn as_mut(&self) -> Option<RefMut<'_, T>>

Deref the inner value mutably.

Trait Implementations

impl<T: Add<Output = T> + Copy + 'static> Add<T> for CopyValue<T>

type Output = T

The resulting type after applying the + operator.

fn add(self, rhs: T) -> Self::Output

Performs the + operation.

impl<T: Add<Output = T> + Copy + 'static> AddAssign<T> for CopyValue<T>

fn add_assign(&mut self, rhs: T)

Performs the += operation.

impl<T> Clone for CopyValue<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 + 'static> Debug for CopyValue<T>

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

Formats the value using the given formatter.

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

fn default() -> Self

Returns the “default value” for a type.

impl<T> Deref for CopyValue<T>

type Target = dyn Fn() -> Ref<'static, T>

The resulting type after dereferencing.

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

Dereferences the value.

impl<T: Display + 'static> Display for CopyValue<T>

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

Formats the value using the given formatter.

impl<T: Div<Output = T> + Copy + 'static> Div<T> for CopyValue<T>

type Output = T

The resulting type after applying the / operator.

fn div(self, rhs: T) -> Self::Output

Performs the / operation.

impl<T: Div<Output = T> + Copy + 'static> DivAssign<T> for CopyValue<T>

fn div_assign(&mut self, rhs: T)

Performs the /= operation.

impl<T: Clone + 'static> IntoIterator for CopyValue<Vec<T>>

type IntoIter = CopyValueIterator<T>

Which kind of iterator are we turning this into?

type Item = T

The type of the elements being iterated over.

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<T: Mul<Output = T> + Copy + 'static> Mul<T> for CopyValue<T>

type Output = T

The resulting type after applying the * operator.

fn mul(self, rhs: T) -> Self::Output

Performs the * operation.

impl<T: Mul<Output = T> + Copy + 'static> MulAssign<T> for CopyValue<T>

fn mul_assign(&mut self, rhs: T)

Performs the *= operation.

impl<T: 'static> PartialEq<CopyValue<T>> for CopyValue<T>

fn eq(&self, other: &Self) -> 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: Sub<Output = T> + Copy + 'static> Sub<T> for CopyValue<T>

type Output = T

The resulting type after applying the - operator.

fn sub(self, rhs: T) -> Self::Output

Performs the - operation.

impl<T: Sub<Output = T> + Copy + 'static> SubAssign<T> for CopyValue<T>

fn sub_assign(&mut self, rhs: T)

Performs the -= operation.

impl<T> Copy for CopyValue<T>