Skip to main content

Memo

Struct Memo 

Source
pub struct Memo<T> { /* private fields */ }
Expand description

A value derived from signals and other memos.

Create one with Owner::memo. It computes nothing until something reads it. When a value it read changes, it only becomes stale, and recomputes the next time something reads it. If the new value equals the old one, the memos and effects that read it don’t rerun.

If its closure panics, the memo is logged and disabled. It keeps its last value, and try_get() returns None if it never had one. A memo must not write signals or call Runtime::flush: either panics, which disables it the same way.

Implementations§

Source§

impl<T: 'static> Memo<T>

Source

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

Returns a clone of the value, recomputing it first if it is stale. Inside a memo or effect, this makes it depend on this memo.

§Panics

If the memo’s owner was disposed, if it has no value because its closure panicked on the first run, or if the memo reads itself. try_get returns None in the first two cases.

Source

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

Calls f with a reference to the value. Otherwise like get.

Source

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

Like get, but records no dependency.

Source

pub fn with_untracked<R>(&self, f: impl FnOnce(&T) -> R) -> R

Like with, but records no dependency.

Source

pub fn try_get(&self) -> Option<T>
where T: Clone,

Like get, but returns None if the owner was disposed or the memo has no value.

Source

pub fn try_with<R>(&self, f: impl FnOnce(&T) -> R) -> Option<R>

Like with, but returns None if the owner was disposed or the memo has no value.

Source

pub fn named(self, name: impl Into<String>) -> Self

Gives the memo a debug name, such as a widget path, for log lines.

Trait Implementations§

Source§

impl<T> Clone for Memo<T>

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl<T> Copy for Memo<T>

Source§

impl<T> Debug for Memo<T>

Source§

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

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

impl<T> Eq for Memo<T>

Source§

impl<T> Hash for Memo<T>

Source§

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher. Read more
1.3.0 · Source§

fn hash_slice<H>(data: &[Self], state: &mut H)
where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher. Read more
Source§

impl<T> PartialEq for Memo<T>

Source§

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

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=. Read more

Auto Trait Implementations§

§

impl<T> !Send for Memo<T>

§

impl<T> !Sync for Memo<T>

§

impl<T> Forget for Memo<T>

§

impl<T> Freeze for Memo<T>
where PhantomData<(fn(T) -> T, *const ())>: Freeze,

§

impl<T> Move for Memo<T>

§

impl<T> RefUnwindSafe for Memo<T>

§

impl<T> Unpin for Memo<T>
where PhantomData<(fn(T) -> T, *const ())>: Unpin,

§

impl<T> UnsafeUnpin for Memo<T>
where PhantomData<(fn(T) -> T, *const ())>: UnsafeUnpin,

§

impl<T> UnwindSafe for Memo<T>
where PhantomData<(fn(T) -> T, *const ())>: 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, dest: *mut u8)

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

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

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

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

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> 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 = !

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

fn try_from(value: U) -> Result<T, !>

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> WithSubscriber for T

Source§

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

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

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