array matches(value, regex)
Returns the result of matching a value against a regular expression.
An array value will return the result of the first matching element, a dictionary value will return the result of the first matching entry key, otherwise the text of value itself is matched.
Both the regular expression syntax and text literals use the backslash \
and left curly bracket {
characters for special purpose. Use \\
and \{
to avoid the text literal interpretation.
Flags embedded as a prefix in regex:
Flag | Description |
---|---|
(?d) | Unix lines mode |
(?i) | Case-insensitive matching (US-ASCII only) |
(?iu) | Case-insensitive matching (Unicode, preferred) |
(?m) | Multiline mode |
(?s) | Dotall mode, use it when matching a multiple line value |
(?u) | Unicode-aware case folding |
(?x) | Ignore whitespace and comments in pattern |
null
if there were no match.