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

# [NAME](#NAME)

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

# [SYNOPSIS](#SYNOPSIS)

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

# [DESCRIPTION](#DESCRIPTION)

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").

# [SEE ALSO](#SEE_ALSO)

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

# [LICENSE](#LICENSE)

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-17 perl v5.44.0

---

Document: Log::Log4perl::Filter::StringMatch(3pm) from perl-log-log4perl 1.58-r1 (Chainguard OS)
Source: https://github.com/mschilli/log4perl.git