mirror of
https://github.com/python/cpython.git
synced 2026-01-08 00:12:42 +00:00
[3.13] gh-122055: Clarify documentation for empty matches in RE (GH-133169) (GH-134218)
(cherry picked from commit 44b73d3cd4)
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
This commit is contained in:
parent
8d92823eca
commit
55a7cb1206
1 changed files with 9 additions and 7 deletions
|
|
@ -988,8 +988,8 @@ Functions
|
|||
That way, separator components are always found at the same relative
|
||||
indices within the result list.
|
||||
|
||||
Empty matches for the pattern split the string only when not adjacent
|
||||
to a previous empty match.
|
||||
Adjacent empty matches are not possible, but an empty match can occur
|
||||
immediately after a non-empty match.
|
||||
|
||||
.. code:: pycon
|
||||
|
||||
|
|
@ -1092,9 +1092,12 @@ Functions
|
|||
|
||||
The optional argument *count* is the maximum number of pattern occurrences to be
|
||||
replaced; *count* must be a non-negative integer. If omitted or zero, all
|
||||
occurrences will be replaced. Empty matches for the pattern are replaced only
|
||||
when not adjacent to a previous empty match, so ``sub('x*', '-', 'abxd')`` returns
|
||||
``'-a-b--d-'``.
|
||||
occurrences will be replaced.
|
||||
|
||||
Adjacent empty matches are not possible, but an empty match can occur
|
||||
immediately after a non-empty match.
|
||||
As a result, ``sub('x*', '-', 'abxd')`` returns ``'-a-b--d-'``
|
||||
instead of ``'-a-b-d-'``.
|
||||
|
||||
.. index:: single: \g; in regular expressions
|
||||
|
||||
|
|
@ -1125,8 +1128,7 @@ Functions
|
|||
.. versionchanged:: 3.7
|
||||
Unknown escapes in *repl* consisting of ``'\'`` and an ASCII letter
|
||||
now are errors.
|
||||
Empty matches for the pattern are replaced when adjacent to a previous
|
||||
non-empty match.
|
||||
An empty match can occur immediately after a non-empty match.
|
||||
|
||||
.. versionchanged:: 3.12
|
||||
Group *id* can only contain ASCII digits.
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue