Struct freya::prelude::Resource

pub struct Resource<T>
where
    T: 'static,
{ /* private fields */ }

Implementations

impl<T> Resource<T>

pub fn restart(&mut self)

Restart the resource’s future.

Will not cancel the previous future, but will ignore any values that it generates.

pub fn cancel(&mut self)

Forcefully cancel the resource’s future.

pub fn pause(&mut self)

Pause the resource’s future.

pub fn resume(&mut self)

Resume the resource’s future.

pub fn clear(&mut self)

Clear the resource’s value.

pub fn task(&self) -> Task

Get a handle to the inner task backing this resource Modify the task through this handle will cause inconsistent state

pub fn finished(&self) -> bool

Is the resource’s future currently finished running?

Reading this does not subscribe to the future’s state

pub fn state(&self) -> ReadOnlySignal<UseResourceState>

Get the current state of the resource’s future.

pub fn value(&self) -> ReadOnlySignal<Option<T>>

Get the current value of the resource’s future.

Trait Implementations

impl<T> Clone for Resource<T>

fn clone(&self) -> Resource<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T> Deref for Resource<T>

where T: Clone,

Allow calling a signal with signal() syntax

Currently only limited to copy types, though could probably specialize for string/arc/rc

type Target = dyn Fn() -> Option<T>

The resulting type after dereferencing.

fn deref(&self) -> &<Resource<T> as Deref>::Target

Dereferences the value.

impl<T> From<Resource<T>> for ReadOnlySignal<Option<T>>

fn from(val: Resource<T>) -> ReadOnlySignal<Option<T>>

Converts to this type from the input type.

impl<T> IntoAttributeValue for Resource<T>

where T: Clone + IntoAttributeValue,

fn into_value(self) -> AttributeValue

Convert into an attribute value

impl<T> IntoDynNode for Resource<T>

where T: Clone + IntoDynNode,

fn into_dyn_node(self) -> DynamicNode

Consume this item along with a scopestate and produce a DynamicNode

impl<T> Readable for Resource<T>

type Target = Option<T>

The target type of the reference.

type Storage = UnsyncStorage

The type of the storage this readable uses.

fn try_read_unchecked( &self ) -> Result<<<Resource<T> as Readable>::Storage as AnyStorage>::Ref<'static, <Resource<T> 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.

fn peek_unchecked( &self ) -> <<Resource<T> as Readable>::Storage as AnyStorage>::Ref<'static, <Resource<T> 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.

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.

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> Copy for Resource<T>