diff options
author | 2022-11-30 15:14:36 -0800 | |
---|---|---|
committer | 2022-11-30 18:14:36 -0500 | |
commit | f4511d3ee97a48d4a13e523d0892d0b62d0c491d (patch) | |
tree | 098cf688bfe6b7443cbcdbf73c0e84bb9e6ac1e9 | |
parent | bpo-47220: Document the optional callback parameter of weakref.WeakMethod (GH... (diff) | |
download | cpython-f4511d3ee97a48d4a13e523d0892d0b62d0c491d.tar.gz cpython-f4511d3ee97a48d4a13e523d0892d0b62d0c491d.tar.bz2 cpython-f4511d3ee97a48d4a13e523d0892d0b62d0c491d.zip |
[3.11] GH-98906 ```re``` module: ```search() vs. match()``` section should mention ```fullmatch()``` (GH-98916) (GH-99912)
GH-98906 ```re``` module: ```search() vs. match()``` section should mention ```fullmatch()``` (GH-98916)
Mention fullmatch along with search and match.
(cherry picked from commit e0f91deb5930ecb02e7f8ced9bd82609e6889fb0)
Co-authored-by: ram vikram singh <ramvikrams243@gmail.com>
Co-authored-by: ram vikram singh <ramvikrams243@gmail.com>
-rw-r--r-- | Doc/library/re.rst | 18 |
1 files changed, 12 insertions, 6 deletions
diff --git a/Doc/library/re.rst b/Doc/library/re.rst index a9e6ac30d1..8e279049a1 100644 --- a/Doc/library/re.rst +++ b/Doc/library/re.rst @@ -1562,16 +1562,22 @@ search() vs. match() .. sectionauthor:: Fred L. Drake, Jr. <fdrake@acm.org> -Python offers two different primitive operations based on regular expressions: -:func:`re.match` checks for a match only at the beginning of the string, while -:func:`re.search` checks for a match anywhere in the string (this is what Perl -does by default). +Python offers different primitive operations based on regular expressions: + ++ :func:`re.match` checks for a match only at the beginning of the string ++ :func:`re.search` checks for a match anywhere in the string + (this is what Perl does by default) ++ :func:`re.fullmatch` checks for entire string to be a match + For example:: >>> re.match("c", "abcdef") # No match >>> re.search("c", "abcdef") # Match <re.Match object; span=(2, 3), match='c'> + >>> re.fullmatch("p.*n", "python") # Match + <re.Match object; span=(0, 6), match='python'> + >>> re.fullmatch("r.*n", "python") # No match Regular expressions beginning with ``'^'`` can be used with :func:`search` to restrict the match at the beginning of the string:: @@ -1585,8 +1591,8 @@ Note however that in :const:`MULTILINE` mode :func:`match` only matches at the beginning of the string, whereas using :func:`search` with a regular expression beginning with ``'^'`` will match at the beginning of each line. :: - >>> re.match('X', 'A\nB\nX', re.MULTILINE) # No match - >>> re.search('^X', 'A\nB\nX', re.MULTILINE) # Match + >>> re.match("X", "A\nB\nX", re.MULTILINE) # No match + >>> re.search("^X", "A\nB\nX", re.MULTILINE) # Match <re.Match object; span=(4, 5), match='X'> |