Devel::Events::Filter::Drop - Remove events that match or don't match a condition.

	use Devel::Events::Filter::Drop;

	my $f = Devel::Events::Filter::Drop->new(
		match        => $cond, # see Devel::Events::Match
		non_matching => 1,     # invert so that nonmatching events get dropped
		handler      => $h,
	);

This filter allows dropping of events that match (or that don't match) a condition. The actual matching is done by Devel::Events::Match.

match

The condition to be passed to compile_cond in Devel::Events::Match.

matcher

An instance of Devel::Events::Match used to compile match.

non_matching

Drop events that don't match the condition, instead of ones that do.

filter_event @event

Delegates to the compiled condition and then returns the event unaltered or returns nothing based on the values of non_matching and the result of the match.