mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-08-22 17:55:18 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 15

Backport doc fixes from 2.6. These are all things that were already

Browse source 
supported but weren't in the docs, like conditional backreferences.
This commit is contained in:
Guido van Rossum 2008-02-05 17:31:37 +00:00
parent 9decb70349
commit 6ae66d7300
1 changed files with 12 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

16
Lib/re.py
View file

@ -29,7 +29,8 @@ concatenate ordinary characters, so last matches the string 'last'.
The special characters are: The special characters are:
"." Matches any character except a newline. "." Matches any character except a newline.
"^" Matches the start of the string. "^" Matches the start of the string.
"$" Matches the end of the string. "$" Matches the end of the string or just before the newline at
the end of the string.
"*" Matches 0 or more (greedy) repetitions of the preceding RE. "*" Matches 0 or more (greedy) repetitions of the preceding RE.
Greedy means that it will match as many repetitions as possible. Greedy means that it will match as many repetitions as possible.
"+" Matches 1 or more (greedy) repetitions of the preceding RE. "+" Matches 1 or more (greedy) repetitions of the preceding RE.
@ -37,7 +38,7 @@ The special characters are:
*?,+?,?? Non-greedy versions of the previous three special characters. *?,+?,?? Non-greedy versions of the previous three special characters.
{m,n} Matches from m to n repetitions of the preceding RE. {m,n} Matches from m to n repetitions of the preceding RE.
{m,n}? Non-greedy version of the above. {m,n}? Non-greedy version of the above.
"\\" Either escapes special characters or signals a special sequence. "\\" Either escapes special characters or signals a special sequence.
[] Indicates a set of characters. [] Indicates a set of characters.
A "^" as the first character indicates a complementing set. A "^" as the first character indicates a complementing set.
"|" A|B, creates an RE that will match either A or B. "|" A|B, creates an RE that will match either A or B.
@ -50,6 +51,10 @@ The special characters are:
(?#...) A comment; ignored. (?#...) A comment; ignored.
(?=...) Matches if ... matches next, but doesn't consume the string. (?=...) Matches if ... matches next, but doesn't consume the string.
(?!...) Matches if ... doesn't match next. (?!...) Matches if ... doesn't match next.
(?<=...) Matches if preceded by ... (must be fixed length).
(?<!...) Matches if not preceded by ... (must be fixed length).
(?(id/name)yes|no) Matches yes pattern if the group with id/name matched,
the (optional) no pattern otherwise.
The special sequences consist of "\\" and a character from the list The special sequences consist of "\\" and a character from the list
below. If the ordinary character is not on the list, then the below. If the ordinary character is not on the list, then the
@ -76,6 +81,7 @@ This module exports the following functions:
subn Same as sub, but also return the number of substitutions made. subn Same as sub, but also return the number of substitutions made.
split Split a string by the occurrences of a pattern. split Split a string by the occurrences of a pattern.
findall Find all occurrences of a pattern in a string. findall Find all occurrences of a pattern in a string.
finditer Return an iterator yielding a match object for each match.
compile Compile a pattern into a RegexObject. compile Compile a pattern into a RegexObject.
purge Clear the regular expression cache. purge Clear the regular expression cache.
escape Backslash all non-alphanumerics in a string. escape Backslash all non-alphanumerics in a string.
@ -83,8 +89,10 @@ This module exports the following functions:
Some of the functions in this module takes flags as optional parameters: Some of the functions in this module takes flags as optional parameters:
I IGNORECASE Perform case-insensitive matching. I IGNORECASE Perform case-insensitive matching.
L LOCALE Make \w, \W, \b, \B, dependent on the current locale. L LOCALE Make \w, \W, \b, \B, dependent on the current locale.
M MULTILINE "^" matches the beginning of lines as well as the string. M MULTILINE "^" matches the beginning of lines (after a newline)
"$" matches the end of lines as well as the string. as well as the string.
"$" matches the end of lines (before a newline) as well
as the end of the string.
S DOTALL "." matches any character at all, including the newline. S DOTALL "." matches any character at all, including the newline.
X VERBOSE Ignore whitespace and comments for nicer looking RE's. X VERBOSE Ignore whitespace and comments for nicer looking RE's.
U UNICODE Make \w, \W, \b, \B, dependent on the Unicode locale. U UNICODE Make \w, \W, \b, \B, dependent on the Unicode locale.