mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-09-30 20:31:52 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 11

bpo-32211: Document the existing bug in re.findall() and re.finditer(). (#4695)

Browse source
This commit is contained in:
Serhiy Storchaka 2018-01-04 11:08:24 +02:00 • committed by GitHub
parent f24c1857a8
commit 1e6d8525f9
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 10 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

14
Doc/library/re.rst
View file

@ -719,14 +719,21 @@ form.
Splitting on a pattern that could match an empty string now raises Splitting on a pattern that could match an empty string now raises
a warning. Patterns that can only match empty strings are now rejected. a warning. Patterns that can only match empty strings are now rejected.
.. function:: findall(pattern, string, flags=0) .. function:: findall(pattern, string, flags=0)
Return all non-overlapping matches of *pattern* in *string*, as a list of Return all non-overlapping matches of *pattern* in *string*, as a list of
strings. The *string* is scanned left-to-right, and matches are returned in strings. The *string* is scanned left-to-right, and matches are returned in
the order found. If one or more groups are present in the pattern, return a the order found. If one or more groups are present in the pattern, return a
list of groups; this will be a list of tuples if the pattern has more than list of groups; this will be a list of tuples if the pattern has more than
one group. Empty matches are included in the result unless they touch the one group. Empty matches are included in the result.
beginning of another match.
.. note::
Due to the limitation of the current implementation the character
following an empty match is not included in a next match, so
``findall(r'^|\w+', 'two words')`` returns ``['', 'wo', 'words']``
(note missed "t"). This is changed in Python 3.7.
.. function:: finditer(pattern, string, flags=0) .. function:: finditer(pattern, string, flags=0)
@ -734,8 +741,7 @@ form.
Return an :term:`iterator` yielding :ref:`match objects <match-objects>` over Return an :term:`iterator` yielding :ref:`match objects <match-objects>` over
all non-overlapping matches for the RE *pattern* in *string*. The *string* all non-overlapping matches for the RE *pattern* in *string*. The *string*
is scanned left-to-right, and matches are returned in the order found. Empty is scanned left-to-right, and matches are returned in the order found. Empty
matches are included in the result unless they touch the beginning of another matches are included in the result. See also the note about :func:`findall`.
match.
.. function:: sub(pattern, repl, string, count=0, flags=0) .. function:: sub(pattern, repl, string, count=0, flags=0)