Struct freya::prelude::GlobalSignal

pub struct GlobalSignal<T> { /* private fields */ }

A signal that can be accessed from anywhere in the application and created in a static

Implementations

impl<T> GlobalSignal<T>

where T: 'static,

pub const fn new(initializer: fn() -> T) -> GlobalSignal<T>

Create a new global signal with the given initializer.

pub fn key(&self) -> GlobalKey<'static>

Get the key for this global

pub const fn with_key( initializer: fn() -> T, key: &'static str ) -> GlobalSignal<T>

Create this global signal with a specific key. This is useful for ensuring that the signal is unique across the application and accessible from outside the application too.

pub fn signal(&self) -> Signal<T>

Get the signal that backs this .

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

Write this value

pub fn origin_scope(&self) -> ScopeId

Get the scope the signal was created in.

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

Run a closure with a mutable reference to the signal’s value. If the signal has been dropped, this will panic.

pub fn id(&self) -> GenerationalBoxId

Get the generational id of the signal.

Trait Implementations

impl<T> Debug for GlobalSignal<T>

where T: Debug + 'static,

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

Formats the value using the given formatter.

impl<T> Deref for GlobalSignal<T>

where T: Clone + 'static,

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

The resulting type after dereferencing.

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

Dereferences the value.

impl<T> Display for GlobalSignal<T>

where T: Display + 'static,

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

Formats the value using the given formatter.

impl<T> PartialEq<T> for GlobalSignal<T>

where T: PartialEq + 'static,

fn eq(&self, other: &T) -> 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> Readable for GlobalSignal<T>

where T: 'static,

type Target = T

The target type of the reference.

type Storage = UnsyncStorage

The type of the storage this readable uses.

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

Try to peek the current value of the signal without subscribing to updates. If the value has been dropped, this will return an error.

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 try_peek( &self ) -> Result<<Self::Storage as AnyStorage>::Ref<'_, Self::Target>, BorrowError>

Try to peek the current value of the signal without subscribing to updates. If the value has been dropped, this will return an error.

fn peek_unchecked( &self ) -> <Self::Storage as AnyStorage>::Ref<'static, Self::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 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> Writable for GlobalSignal<T>

where T: 'static,

type Mut<'a, R: 'static + ?Sized> = Write<'a, R>

The type of the reference.

fn map_mut<I, U, F>( ref_: <GlobalSignal<T> as Writable>::Mut<'_, I>, f: F ) -> <GlobalSignal<T> as Writable>::Mut<'_, U>

where U: 'static + ?Sized, F: FnOnce(&mut I) -> &mut U, I: ?Sized,

Map the reference to a new type.

fn try_map_mut<I, U, F>( ref_: <GlobalSignal<T> as Writable>::Mut<'_, I>, f: F ) -> Option<<GlobalSignal<T> as Writable>::Mut<'_, U>>

where I: 'static + ?Sized, U: 'static + ?Sized, F: FnOnce(&mut I) -> Option<&mut U>,

Try to map the reference to a new type.

fn downcast_lifetime_mut<'a, 'b, R>( mut_: <GlobalSignal<T> as Writable>::Mut<'a, R> ) -> <GlobalSignal<T> as Writable>::Mut<'b, R>

where 'a: 'b, R: 'static + ?Sized,

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

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

Try to get a mutable reference to the value without checking the lifetime. This will update any 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.

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.