Struct Handle

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

Available on crate feature std only.

Allows reloading the state of an associated Collect.

Implementations

impl<T> Handle<T>

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

Replace the current subscriber or filter with the provided new_value.

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

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

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

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

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

where T: Clone,

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

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

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

Trait Implementations

impl<T> Clone for Handle<T>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

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

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

Formats the value using the given formatter.