reactive_stores

Struct KeyedSubfield

Source
pub struct KeyedSubfield<Inner, Prev, K, T>
where for<'a> &'a T: IntoIterator,
{ /* private fields */ }
Expand description

Provides access to a subfield that contains some kind of keyed collection.

Implementations§

Source§

impl<Inner, Prev, K, T> KeyedSubfield<Inner, Prev, K, T>
where for<'a> &'a T: IntoIterator,

Source

pub fn new( inner: Inner, path_segment: StorePathSegment, key_fn: fn(_: <&T as IntoIterator>::Item) -> K, read: fn(_: &Prev) -> &T, write: fn(_: &mut Prev) -> &mut T, ) -> Self

Creates a keyed subfield of the inner data type with the given key function.

Source§

impl<Inner, Prev, K, T> KeyedSubfield<Inner, Prev, K, T>
where Self: Clone, for<'a> &'a T: IntoIterator, Inner: StoreField<Value = Prev>, Prev: 'static, K: Debug + Send + Sync + PartialEq + Eq + Hash + 'static,

Source

pub fn update_keys(&self)

Generates a new set of keys and registers those keys with the parent store.

Trait Implementations§

Source§

impl<Inner, Prev, K, T> Clone for KeyedSubfield<Inner, Prev, K, T>
where for<'a> &'a T: IntoIterator, Inner: Clone,

Source§

fn clone(&self) -> Self

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
Source§

impl<Inner: Debug, Prev: Debug, K: Debug, T: Debug> Debug for KeyedSubfield<Inner, Prev, K, T>
where for<'a> &'a T: IntoIterator,

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<Inner, Prev, K, T> DefinedAt for KeyedSubfield<Inner, Prev, K, T>
where for<'a> &'a T: IntoIterator, Inner: StoreField<Value = Prev>,

Source§

fn defined_at(&self) -> Option<&'static Location<'static>>

Returns the location at which the signal was defined. This is usually simply None in release mode.
Source§

impl<Inner, Prev, K, T> IntoIterator for KeyedSubfield<Inner, Prev, K, T>
where Self: Clone, for<'a> &'a T: IntoIterator, Inner: Clone + StoreField<Value = Prev> + 'static, Prev: 'static, K: Debug + Send + Sync + PartialEq + Eq + Hash + 'static, T: IndexMut<usize> + 'static, T::Output: Sized,

Source§

type Item = AtKeyed<Inner, Prev, K, T>

The type of the elements being iterated over.
Source§

type IntoIter = StoreFieldKeyedIter<Inner, Prev, K, T>

Which kind of iterator are we turning this into?
Source§

fn into_iter(self) -> StoreFieldKeyedIter<Inner, Prev, K, T>

Creates an iterator from a value. Read more
Source§

impl<Inner, Prev, K, T> IsDisposed for KeyedSubfield<Inner, Prev, K, T>
where for<'a> &'a T: IntoIterator, Inner: IsDisposed,

Source§

fn is_disposed(&self) -> bool

If true, the signal cannot be accessed without a panic.
Source§

impl<Inner, Prev, K, T> Notify for KeyedSubfield<Inner, Prev, K, T>
where Self: Clone, for<'a> &'a T: IntoIterator, Inner: StoreField<Value = Prev>, Prev: 'static, K: Debug + Send + Sync + PartialEq + Eq + Hash + 'static,

Source§

fn notify(&self)

Notifies subscribers of a change in this signal.
Source§

impl<Inner, Prev, K, T> ReadUntracked for KeyedSubfield<Inner, Prev, K, T>
where Self: Clone, for<'a> &'a T: IntoIterator, Inner: StoreField<Value = Prev>, Prev: 'static, K: Debug + Send + Sync + PartialEq + Eq + Hash + 'static,

Source§

type Value = <KeyedSubfield<Inner, Prev, K, T> as StoreField>::Reader

The guard type that will be returned, which can be dereferenced to the value.
Source§

fn try_read_untracked(&self) -> Option<Self::Value>

Returns the guard, or None if the signal has already been disposed.
Source§

fn read_untracked(&self) -> Self::Value

Returns the guard. Read more
Source§

fn custom_try_read(&self) -> Option<Option<Self::Value>>

This is a backdoor to allow overriding the Read::try_read implementation despite it being auto implemented. Read more
Source§

impl<Inner, Prev, K, T> StoreField for KeyedSubfield<Inner, Prev, K, T>
where Self: Clone, for<'a> &'a T: IntoIterator, Inner: StoreField<Value = Prev>, Prev: 'static, K: Debug + Send + Sync + PartialEq + Eq + Hash + 'static,

Source§

type Value = T

The value this field contains.
Source§

type Reader = Mapped<<Inner as StoreField>::Reader, T>

A read guard to access this field.
Source§

type Writer = MappedMut<WriteGuard<ArcTrigger, <Inner as StoreField>::Writer>, T>

A write guard to update this field.
Source§

fn path(&self) -> impl IntoIterator<Item = StorePathSegment>

The path of this field (see StorePath).
Source§

fn get_trigger(&self, path: StorePath) -> StoreFieldTrigger

Returns the trigger that tracks access and updates for this field.
Source§

fn reader(&self) -> Option<Self::Reader>

Returns a read guard to access this field.
Source§

fn writer(&self) -> Option<Self::Writer>

Returns a write guard to update this field.
Source§

fn keys(&self) -> Option<KeyMap>

The keys for this field, if it is a keyed field.
Source§

fn track_field(&self)

Reactively tracks this field.
Source§

impl<Inner, Prev, K, T> Track for KeyedSubfield<Inner, Prev, K, T>
where Self: Clone, for<'a> &'a T: IntoIterator, Inner: StoreField<Value = Prev> + Track + 'static, Prev: 'static, T: 'static, K: Debug + Send + Sync + PartialEq + Eq + Hash + 'static,

Source§

fn track(&self)

Subscribes to this signal in the current reactive scope without doing anything with its value.
Source§

impl<Inner, Prev, K, T> Write for KeyedSubfield<Inner, Prev, K, T>
where Self: Clone, for<'a> &'a T: IntoIterator, T: 'static, Inner: StoreField<Value = Prev>, Prev: 'static, K: Debug + Send + Sync + PartialEq + Eq + Hash + 'static,

Source§

type Value = T

The type of the signal’s value.
Source§

fn try_write(&self) -> Option<impl UntrackableGuard<Target = Self::Value>>

Returns the guard, or None if the signal has already been disposed.
Source§

fn try_write_untracked(&self) -> Option<impl DerefMut<Target = Self::Value>>

or None if the signal has already been disposed.
Source§

fn write(&self) -> impl UntrackableGuard

Returns the guard. Read more
Source§

fn write_untracked(&self) -> impl DerefMut

Returns a guard that will not notify subscribers when dropped. Read more
Source§

impl<Inner, Prev, K, T> Copy for KeyedSubfield<Inner, Prev, K, T>
where for<'a> &'a T: IntoIterator, Inner: Copy,

Auto Trait Implementations§

§

impl<Inner, Prev, K, T> Freeze for KeyedSubfield<Inner, Prev, K, T>
where Inner: Freeze,

§

impl<Inner, Prev, K, T> RefUnwindSafe for KeyedSubfield<Inner, Prev, K, T>
where Inner: RefUnwindSafe,

§

impl<Inner, Prev, K, T> Send for KeyedSubfield<Inner, Prev, K, T>
where Inner: Send,

§

impl<Inner, Prev, K, T> Sync for KeyedSubfield<Inner, Prev, K, T>
where Inner: Sync,

§

impl<Inner, Prev, K, T> Unpin for KeyedSubfield<Inner, Prev, K, T>
where Inner: Unpin,

§

impl<Inner, Prev, K, T> UnwindSafe for KeyedSubfield<Inner, Prev, K, T>
where Inner: UnwindSafe,

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
Source§

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

Source§

unsafe fn clone_to_uninit(&self, dst: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dst. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

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
Source§

impl<T> Read for T
where T: Track + ReadUntracked,

Source§

type Value = <T as ReadUntracked>::Value

The guard type that will be returned, which can be dereferenced to the value.
Source§

fn try_read(&self) -> Option<<T as Read>::Value>

Subscribes to the signal, and returns the guard, or None if the signal has already been disposed.
Source§

fn read(&self) -> Self::Value

Subscribes to the signal, and returns the guard. Read more
Source§

impl<T> Set for T
where T: Update + IsDisposed,

Source§

type Value = <T as Update>::Value

The type of the value contained in the signal.
Source§

fn set(&self, value: <T as Set>::Value)

Updates the value by replacing it, and notifies subscribers that it has changed.
Source§

fn try_set(&self, value: <T as Set>::Value) -> Option<<T as Set>::Value>

Updates the value by replacing it, and notifies subscribers that it has changed. Read more
Source§

impl<T> StorageAccess<T> for T

Source§

fn as_borrowed(&self) -> &T

Borrows the value.
Source§

fn into_taken(self) -> T

Takes the value.
Source§

impl<Inner, Prev> StoreFieldIterator<Prev> for Inner
where Inner: StoreField<Value = Prev> + Clone, <Prev as Index<usize>>::Output: Sized, Prev: IndexMut<usize> + AsRef<[<Prev as Index<usize>>::Output]>,

Source§

fn at_unkeyed(self, index: usize) -> AtIndex<Inner, Prev>

Reactive access to the value at some index.
Source§

fn iter_unkeyed(self) -> StoreFieldIter<Inner, Prev>

An iterator over the values in the collection.
Source§

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

Source§

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
Source§

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

Source§

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>,

Source§

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.
Source§

impl<T> Update for T
where T: Write,

Source§

type Value = <T as Write>::Value

The type of the value contained in the signal.
Source§

fn try_maybe_update<U>( &self, fun: impl FnOnce(&mut <T as Update>::Value) -> (bool, U), ) -> Option<U>

Updates the value of the signal, notifying subscribers if the update function returns (true, _), and returns the value returned by the update function, or None if the signal has already been disposed.
Source§

fn update(&self, fun: impl FnOnce(&mut Self::Value))

Updates the value of the signal and notifies subscribers.
Source§

fn maybe_update(&self, fun: impl FnOnce(&mut Self::Value) -> bool)

Updates the value of the signal, but only notifies subscribers if the function returns true.
Source§

fn try_update<U>(&self, fun: impl FnOnce(&mut Self::Value) -> U) -> Option<U>

Updates the value of the signal and notifies subscribers, returning the value that is returned by the update function, or None if the signal has already been disposed.
Source§

impl<T> UpdateUntracked for T
where T: Write,

Source§

type Value = <T as Write>::Value

The type of the value contained in the signal.
Source§

fn try_update_untracked<U>( &self, fun: impl FnOnce(&mut <T as UpdateUntracked>::Value) -> U, ) -> Option<U>

Updates the value by applying a function, returning the value returned by that function, or None if the signal has already been disposed. Does not notify subscribers that the signal has changed.
Source§

fn update_untracked<U>(&self, fun: impl FnOnce(&mut Self::Value) -> U) -> U

Updates the value by applying a function, returning the value returned by that function. Does not notify subscribers that the signal has changed. Read more
Source§

impl<T> With for T
where T: Read,

Source§

type Value = <<T as Read>::Value as Deref>::Target

The type of the value contained in the signal.
Source§

fn try_with<U>(&self, fun: impl FnOnce(&<T as With>::Value) -> U) -> Option<U>

Subscribes to the signal, applies the closure to the value, and returns the result, or None if the signal has already been disposed.
Source§

fn with<U>(&self, fun: impl FnOnce(&Self::Value) -> U) -> U

Subscribes to the signal, applies the closure to the value, and returns the result. Read more
Source§

impl<T> WithUntracked for T

Source§

type Value = <<T as ReadUntracked>::Value as Deref>::Target

The type of the value contained in the signal.
Source§

fn try_with_untracked<U>( &self, fun: impl FnOnce(&<T as WithUntracked>::Value) -> U, ) -> Option<U>

Applies the closure to the value, and returns the result, or None if the signal has already been disposed.
Source§

fn with_untracked<U>(&self, fun: impl FnOnce(&Self::Value) -> U) -> U

Applies the closure to the value, and returns the result. Read more