Filter::StringMatch(3) User Contributed Perl Documentation Filter::StringMatch(3)

Log::Log4perl::Filter::StringMatch - Filter on log message string

log4perl.filter.Match1               = Log::Log4perl::Filter::StringMatch
log4perl.filter.Match1.StringToMatch = blah blah
log4perl.filter.Match1.AcceptOnMatch = true

This Log4perl custom filter checks if the currently submitted message matches a predefined regular expression, as set in the "StringToMatch" parameter. It uses common Perl 5 regexes.

The additional parameter "AcceptOnMatch" defines if the filter is supposed to pass or block the message on a match ("true" or "false").

Log::Log4perl::Filter, Log::Log4perl::Filter::Boolean, Log::Log4perl::Filter::LevelMatch, Log::Log4perl::Filter::LevelRange, Log::Log4perl::Filter::MDC

Copyright 2002-2026 by Mike Schilli <m@perlmeister.com> and Kevin Goess <cpan@goess.org>.

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

2026-08-14 perl v5.42.2