---
name: "Log::Log4perl::Filter::StringMatch"
section: "3pm"
platform: "linux"
package: "perl-log-log4perl"
version: "1.58-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/Log::Log4perl::Filter::StringMatch"
---

# Log::Log4perl::Filter::StringMatch(3pm)

Filter on log message string

## NAME

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

## SYNOPSIS

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

## 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

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

## 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.