mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-11-01 18:51:43 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 21

gh-99308: Clarify re docs for byte pattern group names (#99311)

Browse source
This commit is contained in:
Ilya Kulakov 2022-12-24 22:55:27 -08:00 • committed by GitHub
parent b9aa14a484
commit dbc1e696eb
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 9 additions and 7 deletions
Download patch file Download diff file Expand all files Collapse all files

16
Doc/library/re.rst
View file

@ -395,9 +395,9 @@ The special characters are:
``(?P<name>...)``
Similar to regular parentheses, but the substring matched by the group is
accessible via the symbolic group name *name*. Group names must be valid
Python identifiers, and in bytes patterns they must contain only characters
in the ASCII range. Each group name must be defined only once within a
regular expression. A symbolic group is also a numbered group, just as if
Python identifiers, and in :class:`bytes` patterns they can only contain
bytes in the ASCII range. Each group name must be defined only once within
a regular expression. A symbolic group is also a numbered group, just as if
the group were not named.
Named groups can be referenced in three contexts. If the pattern is
@ -419,8 +419,8 @@ The special characters are:
+---------------------------------------+----------------------------------+
.. versionchanged:: 3.12
In bytes patterns group names must contain only characters in
the ASCII range.
In :class:`bytes` patterns, group *name* can only contain bytes
in the ASCII range (``b'\x00'``-``b'\x7f'``).
.. index:: single: (?P=; in regular expressions
@ -496,6 +496,8 @@ The special characters are:
.. versionchanged:: 3.12
Group *id* can only contain ASCII digits.
In :class:`bytes` patterns, group *name* can only contain bytes
in the ASCII range (``b'\x00'``-``b'\x7f'``).
The special sequences consist of ``'\'`` and a character from the list below.
@ -1018,8 +1020,8 @@ Functions
.. versionchanged:: 3.12
Group *id* can only contain ASCII digits.
In bytes replacement strings group names must contain only characters
in the ASCII range.
In :class:`bytes` replacement strings, group *name* can only contain bytes
in the ASCII range (``b'\x00'``-``b'\x7f'``).
.. function:: subn(pattern, repl, string, count=0, flags=0)