NAME

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

VERSION

version 0.09

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.

SUPPORT

Bugs may be submitted through the RT bug tracker <https://rt.cpan.org/Public/Dist/Display.html?Name=Devel-Events> (or bug-Devel-Events@rt.cpan.org <mailto:bug-Devel-Events@rt.cpan.org>).

AUTHOR

XXXX XXX'XX (Yuval Kogman) <nothingmuch@woobling.org>

COPYRIGHT AND LICENCE

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.