-as the L<references|/"SEE ALSO"> section in this document.
-
-=head1 OPERATORS
-
- =~ determines to which variable the regex is applied.
- In its absence, $_ is used.
-
- $var =~ /foo/;
-
- m/pattern/igmsoxc searches a string for a pattern match,
- applying the given options.
-
- i case-Insensitive
- g Global - all occurrences
- m Multiline mode - ^ and $ match internal lines
- s match as a Single line - . matches \n
- o compile pattern Once
- x eXtended legibility - free whitespace and comments
- c don't reset pos on fails when using /g
-
- If 'pattern' is an empty string, the last I<successfully> match
- regex is used. Delimiters other than '/' may be used for both this
- operator and the following ones.
-
- qr/pattern/imsox lets you store a regex in a variable,
- or pass one around. Modifiers as for m// and are stored
- within the regex.
-
- s/pattern/replacement/igmsoxe substitutes matches of
- 'pattern' with 'replacement'. Modifiers as for m//
- with one addition:
-
- e Evaluate replacement as an expression
-
- 'e' may be specified multiple times. 'replacement' is interpreted
- as a double quoted string unless a single-quote (') is the delimiter.
-
- ?pattern? is like m/pattern/ but matches only once. No alternate
- delimiters can be used. Must be reset with 'reset'.
-
-=head1 SYNTAX
-
- \ Escapes the character(s) immediately following it
- . Matches any single character except a newline (unless /s is used)
- ^ Matches at the beginning of the string (or line, if /m is used)
- $ Matches at the end of the string (or line, if /m is used)
- * Matches the preceding element 0 or more times
- + Matches the preceding element 1 or more times
- ? Matches the preceding element 0 or 1 times
- {...} Specifies a range of occurrences for the element preceding it
- [...] Matches any one of the characters contained within the brackets
- (...) Groups subexpressions for capturing to $1, $2...
- (?:...) Groups subexpressions without capturing (cluster)
- | Matches either the expression preceding or following it
- \1, \2 ... The text from the Nth group
+as the L</"SEE ALSO"> section in this document.
+
+=head2 OPERATORS
+
+C<=~> determines to which variable the regex is applied.
+In its absence, $_ is used.
+
+ $var =~ /foo/;
+
+C<!~> determines to which variable the regex is applied,
+and negates the result of the match; it returns
+false if the match succeeds, and true if it fails.
+
+ $var !~ /foo/;
+
+C<m/pattern/msixpogcdualn> searches a string for a pattern match,
+applying the given options.
+
+ m Multiline mode - ^ and $ match internal lines
+ s match as a Single line - . matches \n
+ i case-Insensitive
+ x eXtended legibility - free whitespace and comments
+ p Preserve a copy of the matched string -
+ ${^PREMATCH}, ${^MATCH}, ${^POSTMATCH} will be defined.
+ o compile pattern Once
+ g Global - all occurrences
+ c don't reset pos on failed matches when using /g
+ a restrict \d, \s, \w and [:posix:] to match ASCII only
+ aa (two a's) also /i matches exclude ASCII/non-ASCII
+ l match according to current locale
+ u match according to Unicode rules
+ d match according to native rules unless something indicates
+ Unicode
+ n Non-capture mode. Don't let () fill in $1, $2, etc...
+
+If 'pattern' is an empty string, the last I<successfully> matched
+regex is used. Delimiters other than '/' may be used for both this
+operator and the following ones. The leading C<m> can be omitted
+if the delimiter is '/'.
+
+C<qr/pattern/msixpodualn> lets you store a regex in a variable,
+or pass one around. Modifiers as for C<m//>, and are stored
+within the regex.
+
+C<s/pattern/replacement/msixpogcedual> substitutes matches of
+'pattern' with 'replacement'. Modifiers as for C<m//>,
+with two additions:
+
+ e Evaluate 'replacement' as an expression
+ r Return substitution and leave the original string untouched.
+
+'e' may be specified multiple times. 'replacement' is interpreted
+as a double quoted string unless a single-quote (C<'>) is the delimiter.
+
+C<?pattern?> is like C<m/pattern/> but matches only once. No alternate
+delimiters can be used. Must be reset with reset().
+
+=head2 SYNTAX
+
+ \ Escapes the character immediately following it
+ . Matches any single character except a newline (unless /s is
+ used)
+ ^ Matches at the beginning of the string (or line, if /m is used)
+ $ Matches at the end of the string (or line, if /m is used)
+ * Matches the preceding element 0 or more times
+ + Matches the preceding element 1 or more times
+ ? Matches the preceding element 0 or 1 times
+ {...} Specifies a range of occurrences for the element preceding it
+ [...] Matches any one of the characters contained within the brackets
+ (...) Groups subexpressions for capturing to $1, $2...
+ (?:...) Groups subexpressions without capturing (cluster)
+ | Matches either the subexpression preceding or following it
+ \g1 or \g{1}, \g2 ... Matches the text from the Nth group
+ \1, \2, \3 ... Matches the text from the Nth group
+ \g-1 or \g{-1}, \g-2 ... Matches the text from the Nth previous group
+ \g{name} Named backreference
+ \k<name> Named backreference
+ \k'name' Named backreference
+ (?P=name) Named backreference (python syntax)
https://perl5.git.perl.org / perl5.git / blobdiff