NAME

OpenXPKI::Connector::Regex;

DESCRIPTION

In match mode (replace is not set), return literal 0|1 if the given argument(s) match the expression for any get call. In case multiple arguments are passed, all arguments must match to get a true result.

If get_hash is called, only a single argument is allowed. If matched, the value set in the value parameter is returned (default is the empty hash). If not matched, undef is returned (exception if die_on_undef is set).

If invert is set, the pattern match result is inverted - for each item! For multiple arguments this means you get a true result only of no value matches!

In replace mode (allowed with get only), the result of the substituion is returned, multiple arguments are not supported.

Configuration

LOCATION: The regular expression to check against.
modifier: optional, default modifier is xi
replace: If set, the connector works in replace mode with the given value placed in the replace part of the perl substitution operator. "s{LOCATION}{replace}".
Only allowed with the get call.
value: Only used with get_hash call. Contains a hashref which is returned when the regex matched.