Struct freya::prelude::CopyValue

pub struct CopyValue<T, S = UnsyncStorage>
where T: 'static, S: Storage<T>,
{ /* private fields */ }
Expand description

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> CopyValue<T>
where T: 'static,

pub fn new(value: T) -> CopyValue<T>

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) -> CopyValue<T>

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

§

impl<T, S> CopyValue<T, S>
where T: 'static, S: Storage<T>,

pub fn new_maybe_sync(value: T) -> CopyValue<T, S>

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_maybe_sync_in_scope(value: T, scope: ScopeId) -> CopyValue<T, S>

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 manually_drop(&self) -> Option<T>

Manually drop the value in the CopyValue, invalidating the value in the process.

pub fn origin_scope(&self) -> ScopeId

Get the scope this value was created in.

pub fn id(&self) -> GenerationalBoxId

Get the generational id of the value.

Trait Implementations§

§

impl<T, S> Add<T> for CopyValue<T, S>
where T: Add<Output = T> + Copy + 'static, S: Storage<T>,

§

type Output = T

The resulting type after applying the + operator.
§

fn add(self, rhs: T) -> <CopyValue<T, S> as Add<T>>::Output

Performs the + operation. Read more
§

impl<T, S> AddAssign<T> for CopyValue<T, S>
where T: Add<Output = T> + Copy + 'static, S: Storage<T>,

§

fn add_assign(&mut self, rhs: T)

Performs the += operation. Read more
§

impl<T, S> Clone for CopyValue<T, S>
where S: Storage<T>,

§

fn clone(&self) -> CopyValue<T, S>

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
§

impl<T, S> Debug for CopyValue<T, S>
where T: Debug + 'static, S: Storage<T>,

§

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

Formats the value using the given formatter. Read more
§

impl<T, S> Default for CopyValue<T, S>
where T: Default + 'static, S: Storage<T>,

§

fn default() -> CopyValue<T, S>

Returns the “default value” for a type. Read more
§

impl<T, S> Deref for CopyValue<T, S>
where T: Copy, S: Storage<T>,

§

type Target = dyn Fn() -> T

The resulting type after dereferencing.
§

fn deref(&self) -> &<CopyValue<T, S> as Deref>::Target

Dereferences the value.
§

impl<T, S> Display for CopyValue<T, S>
where T: Display + 'static, S: Storage<T>,

§

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

Formats the value using the given formatter. Read more
§

impl<T, S> Div<T> for CopyValue<T, S>
where T: Div<Output = T> + Copy + 'static, S: Storage<T>,

§

type Output = T

The resulting type after applying the / operator.
§

fn div(self, rhs: T) -> <CopyValue<T, S> as Div<T>>::Output

Performs the / operation. Read more
§

impl<T, S> DivAssign<T> for CopyValue<T, S>
where T: Div<Output = T> + Copy + 'static, S: Storage<T>,

§

fn div_assign(&mut self, rhs: T)

Performs the /= operation. Read more
§

impl<T, S> Mul<T> for CopyValue<T, S>
where T: Mul<Output = T> + Copy + 'static, S: Storage<T>,

§

type Output = T

The resulting type after applying the * operator.
§

fn mul(self, rhs: T) -> <CopyValue<T, S> as Mul<T>>::Output

Performs the * operation. Read more
§

impl<T, S> MulAssign<T> for CopyValue<T, S>
where T: Mul<Output = T> + Copy + 'static, S: Storage<T>,

§

fn mul_assign(&mut self, rhs: T)

Performs the *= operation. Read more
§

impl<T, S> PartialEq<T> for CopyValue<T, S>
where T: PartialEq + 'static, S: Storage<T>,

§

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

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

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, S> PartialEq for CopyValue<T, S>
where T: 'static, S: Storage<T>,

§

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

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

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, S> Readable for CopyValue<T, S>
where T: 'static, S: Storage<T>,

§

type Target = T

The target type of the reference.
§

type Storage = S

The type of the storage this readable uses.
§

fn try_read_unchecked( &self ) -> Result<<<CopyValue<T, S> as Readable>::Storage as AnyStorage>::Ref<'static, <CopyValue<T, S> as Readable>::Target>, BorrowError>

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

fn peek_unchecked( &self ) -> <<CopyValue<T, S> as Readable>::Storage as AnyStorage>::Ref<'static, <CopyValue<T, S> as Readable>::Target>

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. Read more
§

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

Map the readable type to a new type.
§

fn read(&self) -> <Self::Storage as AnyStorage>::Ref<'_, Self::Target>

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<<Self::Storage as AnyStorage>::Ref<'_, Self::Target>, 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 ) -> <Self::Storage as AnyStorage>::Ref<'static, Self::Target>

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

fn peek(&self) -> <Self::Storage as AnyStorage>::Ref<'_, Self::Target>

Get the current value of the state without subscribing to updates. 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 ) -> <Self::Storage as AnyStorage>::Ref<'_, <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.
§

impl<T, S> Sub<T> for CopyValue<T, S>
where T: Sub<Output = T> + Copy + 'static, S: Storage<T>,

§

type Output = T

The resulting type after applying the - operator.
§

fn sub(self, rhs: T) -> <CopyValue<T, S> as Sub<T>>::Output

Performs the - operation. Read more
§

impl<T, S> SubAssign<T> for CopyValue<T, S>
where T: Sub<Output = T> + Copy + 'static, S: Storage<T>,

§

fn sub_assign(&mut self, rhs: T)

Performs the -= operation. Read more
§

impl<T, S> Writable for CopyValue<T, S>
where T: 'static, S: Storage<T>,

§

type Mut<'a, R: 'static + ?Sized> = <S as AnyStorage>::Mut<'a, R>

The type of the reference.
§

fn map_mut<I, U, F>( mut_: <CopyValue<T, S> as Writable>::Mut<'_, I>, f: F ) -> <CopyValue<T, S> as Writable>::Mut<'_, U>
where F: FnOnce(&mut I) -> &mut U, I: ?Sized, U: ?Sized,

Map the reference to a new type.
§

fn try_map_mut<I, U, F>( mut_: <CopyValue<T, S> as Writable>::Mut<'_, I>, f: F ) -> Option<<CopyValue<T, S> as Writable>::Mut<'_, U>>
where F: FnOnce(&mut I) -> Option<&mut U>, I: ?Sized, U: ?Sized,

Try to map the reference to a new type.
§

fn downcast_lifetime_mut<'a, 'b, R>( mut_: <CopyValue<T, S> as Writable>::Mut<'a, R> ) -> <CopyValue<T, S> as Writable>::Mut<'b, R>
where 'a: 'b, R: 'static + ?Sized,

Downcast a mutable reference in a RefMut to a more specific lifetime Read more
§

fn try_write_unchecked( &self ) -> Result<<CopyValue<T, S> as Writable>::Mut<'static, <CopyValue<T, S> as Readable>::Target>, BorrowMutError>

Try to get a mutable reference to the value without checking the lifetime. This will update any subscribers. Read more
§

fn set(&mut self, value: T)

Set the value of the signal. This will trigger an update on all subscribers.
§

fn write(&mut self) -> Self::Mut<'_, Self::Target>

Get a mutable reference to the value. If the value has been dropped, this will panic.
§

fn try_write(&mut self) -> Result<Self::Mut<'_, Self::Target>, BorrowMutError>

Try to get a mutable reference to the value.
§

fn write_unchecked(&self) -> Self::Mut<'static, Self::Target>

Get a mutable reference to the value without checking the lifetime. This will update any subscribers. Read more
§

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

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

fn index_mut<I>( &mut self, index: I ) -> Self::Mut<'_, <Self::Target as Index<I>>::Output>
where Self::Target: IndexMut<I>,

Index into the inner value and return a reference to the result.
§

impl<T, S> Copy for CopyValue<T, S>
where S: Storage<T>,

§

impl<T, S> Eq for CopyValue<T, S>
where T: 'static, S: Storage<T>,

Auto Trait Implementations§

§

impl<T, S> Freeze for CopyValue<T, S>

§

impl<T, S = UnsyncStorage> !RefUnwindSafe for CopyValue<T, S>

§

impl<T, S> Send for CopyValue<T, S>
where T: Send, S: Sync,

§

impl<T, S> Sync for CopyValue<T, S>
where T: Sync, S: Sync,

§

impl<T, S> Unpin for CopyValue<T, S>
where T: Unpin,

§

impl<T, S = UnsyncStorage> !UnwindSafe for CopyValue<T, S>

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
§

impl<T> Downcast for T
where T: Any,

§

fn into_any(self: Box<T>) -> Box<dyn Any>

Convert Box<dyn Trait> (where Trait: Downcast) to Box<dyn Any>. Box<dyn Any> can then be further downcast into Box<ConcreteType> where ConcreteType implements Trait.
§

fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>

Convert Rc<Trait> (where Trait: Downcast) to Rc<Any>. Rc<Any> can then be further downcast into Rc<ConcreteType> where ConcreteType implements Trait.
§

fn as_any(&self) -> &(dyn Any + 'static)

Convert &Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &Any’s vtable from &Trait’s.
§

fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)

Convert &mut Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &mut Any’s vtable from &mut Trait’s.
§

impl<T> DowncastSync for T
where T: Any + Send + Sync,

§

fn into_any_arc(self: Arc<T>) -> Arc<dyn Any + Sync + Send>

Convert Arc<Trait> (where Trait: Downcast) to Arc<Any>. Arc<Any> can then be further downcast into Arc<ConcreteType> where ConcreteType implements Trait.
§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

§

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more
§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> IntoEither for T

source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
§

impl<T> NoneValue for T
where T: Default,

§

type NoneType = T

§

fn null_value() -> T

The none-equivalent value.
§

impl<T> Pointable for T

§

const ALIGN: usize = _

The alignment of pointer.
§

type Init = T

The type for initializers.
§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
source§

impl<R, P> ReadPrimitive<R> for P
where R: Read + ReadEndian<P>, P: Default,

source§

fn read_from_little_endian(read: &mut R) -> Result<Self, Error>

Read this value from the supplied reader. Same as ReadEndian::read_from_little_endian().
source§

fn read_from_big_endian(read: &mut R) -> Result<Self, Error>

Read this value from the supplied reader. Same as ReadEndian::read_from_big_endian().
source§

fn read_from_native_endian(read: &mut R) -> Result<Self, Error>

Read this value from the supplied reader. Same as ReadEndian::read_from_native_endian().
§

impl<T, R> ReadableOptionExt<T> for R
where T: 'static, R: Readable<Target = Option<T>>,

§

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

Unwraps the inner value and clones it.
§

fn as_ref(&self) -> Option<<Self::Storage as AnyStorage>::Ref<'_, T>>

Attempts to read the inner value of the Option.
§

impl<T, R> ReadableVecExt<T> for R
where T: 'static, R: Readable<Target = Vec<T>>,

§

fn len(&self) -> usize

Returns the length of the inner vector.
§

fn is_empty(&self) -> bool

Returns true if the inner vector is empty.
§

fn first(&self) -> Option<<Self::Storage as AnyStorage>::Ref<'_, T>>

Get the first element of the inner vector.
§

fn last(&self) -> Option<<Self::Storage as AnyStorage>::Ref<'_, T>>

Get the last element of the inner vector.
§

fn get(&self, index: usize) -> Option<<Self::Storage as AnyStorage>::Ref<'_, T>>

Get the element at the given index of the inner vector.
§

fn iter(&self) -> ReadableValueIterator<'_, Self>
where Self: Sized,

Get an iterator over the values of the inner vector.
source§

impl<T> Same for T

§

type Output = T

Should always be Self
§

impl<T, O> SuperFrom<T> for O
where O: From<T>,

§

fn super_from(input: T) -> O

Convert from a type to another type.
§

impl<T, O, M> SuperInto<O, M> for T
where O: SuperFrom<T, M>,

§

fn super_into(self) -> O

Convert from a type to another type.
§

impl<T> To for T
where T: ?Sized,

§

fn to<T>(self) -> T
where Self: Into<T>,

Converts to T by calling Into<T>::into.
§

fn try_to<T>(self) -> Result<T, Self::Error>
where Self: TryInto<T>,

Tries to convert to T by calling TryInto<T>::try_into.
source§

impl<T> ToOwned for T
where T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
§

impl<T> ToSmolStr for T
where T: Display + ?Sized,

§

fn to_smolstr(&self) -> SmolStr

source§

impl<T> ToString for T
where T: Display + ?Sized,

source§

default fn to_string(&self) -> String

Converts the given value to a String. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<Cfg> TryIntoConfig for Cfg

§

fn into_config(self) -> Option<Cfg>

§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

§

fn vzip(self) -> V

§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

impl<T, W> WritableOptionExt<T> for W
where T: 'static, W: Writable<Target = Option<T>>,

§

fn get_or_insert(&mut self, default: T) -> Self::Mut<'_, T>

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

fn get_or_insert_with( &mut self, default: impl FnOnce() -> T ) -> Self::Mut<'_, T>

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

fn as_mut(&mut self) -> Option<Self::Mut<'_, T>>

Attempts to write the inner value of the Option.
§

impl<T, W> WritableVecExt<T> for W
where T: 'static, W: Writable<Target = Vec<T>>,

§

fn push(&mut self, value: T)

Pushes a new value to the end of the vector.
§

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

Pops the last value from the vector.
§

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

Inserts a new value at the given index.
§

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

Removes the value at the given index.
§

fn clear(&mut self)

Clears the vector, removing all values.
§

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

Extends the vector with the given iterator.
§

fn truncate(&mut self, len: usize)

Truncates the vector to the given length.
§

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

Swaps two values in the vector.
§

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

Retains only the values that match the given predicate.
§

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

Splits the vector into two at the given index.
§

fn get_mut(&mut self, index: usize) -> Option<Self::Mut<'_, T>>

Try to mutably get an element from the vector.
§

fn iter_mut(&mut self) -> WritableValueIterator<'_, Self>
where Self: Sized + Clone,

Gets an iterator over the values of the vector.
§

impl<T> CloneAny for T
where T: Any + Clone,

§

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