pub struct Filtered<L, F, S> { /* private fields */ }
registry
and std
only.Expand description
A Layer
that wraps an inner Layer
and adds a Filter
which
controls what spans and events are enabled for that layer.
This is returned by the Layer::with_filter
method. See the
documentation on per-layer filtering for details.
Implementations§
Source§impl<L, F, S> Filtered<L, F, S>
impl<L, F, S> Filtered<L, F, S>
Sourcepub fn new(layer: L, filter: F) -> Self
pub fn new(layer: L, filter: F) -> Self
Wraps the provided Layer
so that it is filtered by the given
Filter
.
This is equivalent to calling the Layer::with_filter
method.
See the documentation on per-layer filtering for details.
Sourcepub fn filter_mut(&mut self) -> &mut F
pub fn filter_mut(&mut self) -> &mut F
Mutably borrows the Filter
used by this layer.
When this layer can be mutably borrowed, this may be used to mutate the filter.
Generally, this will primarily be used with the
reload::Handle::modify
method.
§Examples
let filtered_layer = fmt::Layer::default().with_filter(filter::LevelFilter::WARN);
let (filtered_layer, reload_handle) = reload::Layer::new(filtered_layer);
info!("This will be ignored");
reload_handle.modify(|layer| *layer.filter_mut() = filter::LevelFilter::INFO);
info!("This will be logged");
Sourcepub fn inner_mut(&mut self) -> &mut L
pub fn inner_mut(&mut self) -> &mut L
Mutably borrows the inner Layer
wrapped by this Filtered
layer.
This method is primarily expected to be used with the
reload::Handle::modify
method.
§Examples
let filtered_layer = fmt::layer().with_writer(non_blocking(std::io::stderr())).with_filter(filter::LevelFilter::INFO);
let (filtered_layer, reload_handle) = reload::Layer::new(filtered_layer);
info!("This will be logged to stderr");
reload_handle.modify(|layer| *layer.inner_mut().writer_mut() = non_blocking(std::io::stdout()));
info!("This will be logged to stdout");
Trait Implementations§
Source§impl<S, L, F> Layer<S> for Filtered<L, F, S>
impl<S, L, F> Layer<S> for Filtered<L, F, S>
Source§fn on_register_dispatch(&self, subscriber: &Dispatch)
fn on_register_dispatch(&self, subscriber: &Dispatch)
Subscriber
. Read moreSource§fn register_callsite(&self, metadata: &'static Metadata<'static>) -> Interest
fn register_callsite(&self, metadata: &'static Metadata<'static>) -> Interest
Subscriber::register_callsite
. Read moreSource§fn enabled(&self, metadata: &Metadata<'_>, cx: Context<'_, S>) -> bool
fn enabled(&self, metadata: &Metadata<'_>, cx: Context<'_, S>) -> bool
true
if this layer is interested in a span or event with the
given metadata
in the current Context
, similarly to
Subscriber::enabled
. Read moreSource§fn on_new_span(&self, attrs: &Attributes<'_>, id: &Id, cx: Context<'_, S>)
fn on_new_span(&self, attrs: &Attributes<'_>, id: &Id, cx: Context<'_, S>)
Attributes
and Id
.Source§fn on_record(&self, span: &Id, values: &Record<'_>, cx: Context<'_, S>)
fn on_record(&self, span: &Id, values: &Record<'_>, cx: Context<'_, S>)
Id
recorded the given
values
.Source§fn on_follows_from(&self, span: &Id, follows: &Id, cx: Context<'_, S>)
fn on_follows_from(&self, span: &Id, follows: &Id, cx: Context<'_, S>)
span
recorded that it
follows from the span with the ID follows
.Source§fn on_event(&self, event: &Event<'_>, cx: Context<'_, S>)
fn on_event(&self, event: &Event<'_>, cx: Context<'_, S>)
Source§fn on_enter(&self, id: &Id, cx: Context<'_, S>)
fn on_enter(&self, id: &Id, cx: Context<'_, S>)
Source§fn on_exit(&self, id: &Id, cx: Context<'_, S>)
fn on_exit(&self, id: &Id, cx: Context<'_, S>)
Source§fn on_close(&self, id: Id, cx: Context<'_, S>)
fn on_close(&self, id: Id, cx: Context<'_, S>)
Source§fn on_id_change(&self, old: &Id, new: &Id, cx: Context<'_, S>)
fn on_id_change(&self, old: &Id, new: &Id, cx: Context<'_, S>)
Source§fn and_then<L>(self, layer: L) -> Layered<L, Self, S> ⓘ
fn and_then<L>(self, layer: L) -> Layered<L, Self, S> ⓘ
Layer
, returning a Layered
struct implementing Layer
. Read moreSource§fn with_subscriber(self, inner: S) -> Layered<Self, S> ⓘwhere
Self: Sized,
fn with_subscriber(self, inner: S) -> Layered<Self, S> ⓘwhere
Self: Sized,
Layer
with the given Subscriber
, returning a
Layered
struct that implements Subscriber
. Read moreSource§fn with_filter<F>(self, filter: F) -> Filtered<Self, F, S> ⓘ
fn with_filter<F>(self, filter: F) -> Filtered<Self, F, S> ⓘ
Auto Trait Implementations§
impl<L, F, S> Freeze for Filtered<L, F, S>
impl<L, F, S> RefUnwindSafe for Filtered<L, F, S>where
F: RefUnwindSafe,
L: RefUnwindSafe,
impl<L, F, S> Send for Filtered<L, F, S>
impl<L, F, S> Sync for Filtered<L, F, S>
impl<L, F, S> Unpin for Filtered<L, F, S>
impl<L, F, S> UnwindSafe for Filtered<L, F, S>where
F: UnwindSafe,
L: UnwindSafe,
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Layout§
Note: Unable to compute type layout, possibly due to this type having generic parameters. Layout can only be computed for concrete, fully-instantiated types.