Struct Handle

pub struct Handle<L, S> { /* private fields */ }

Available on crate feature std only.

Allows reloading the state of an associated Layer.

Implementations

impl<L, S> Handle<L, S>

pub fn reload(&self, new_value: impl Into<L>) -> Result<(), Error>

Replace the current Layer or Filter with the provided new_value.

Handle::reload cannot be used with the Filtered layer; use Handle::modify instead (see this issue for additional details).

However, if the only the Filter needs to be modified, use reload::Layer to wrap the Filter directly.

pub fn modify(&self, f: impl FnOnce(&mut L)) -> Result<(), Error>

Invokes a closure with a mutable reference to the current layer or filter, allowing it to be modified in place.

pub fn clone_current(&self) -> Option<L>

where L: Clone,

Returns a clone of the layer or filter’s current value if it still exists. Otherwise, if the subscriber has been dropped, returns None.

pub fn with_current<T>(&self, f: impl FnOnce(&L) -> T) -> Result<T, Error>

Invokes a closure with a borrowed reference to the current layer or filter, returning the result (or an error if the subscriber no longer exists).

Trait Implementations

impl<L, S> Clone for Handle<L, S>

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<L: Debug, S: Debug> Debug for Handle<L, S>

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

Formats the value using the given formatter.