Devel::Events::Filter::Drop(3)

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

SYNOPSIS
        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,
        );

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

ATTRIBUTES

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.

METHODS

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.