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.

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 8 bytes