https://github.com/python/cpython/commit/c1744902c7c8cf7d68949db19a6e3e49dee4296c
commit: c1744902c7c8cf7d68949db19a6e3e49dee4296c
branch: 3.13
author: Miss Islington (bot) <31488909+miss-isling...@users.noreply.github.com>
committer: hugovk <1324225+hug...@users.noreply.github.com>
date: 2025-04-10T13:48:57Z
summary:
[3.13] gh-106482: Clarify documentation of character set in RE (GH-106517)
(#132365)
Co-authored-by: Serhiy Storchaka <storch...@gmail.com>
Co-authored-by: Martin Panter <vadm...@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <1324225+hug...@users.noreply.github.com>
files:
M Doc/library/re.rst
diff --git a/Doc/library/re.rst b/Doc/library/re.rst
index 9db6f1da3be4db..a4ec538ee813a6 100644
--- a/Doc/library/re.rst
+++ b/Doc/library/re.rst
@@ -250,14 +250,23 @@ The special characters are:
``[a\-z]``) or if it's placed as the first or last character
(e.g. ``[-a]`` or ``[a-]``), it will match a literal ``'-'``.
- * Special characters lose their special meaning inside sets. For example,
+ * Special characters except backslash lose their special meaning inside
sets.
+ For example,
``[(+*)]`` will match any of the literal characters ``'('``, ``'+'``,
``'*'``, or ``')'``.
.. index:: single: \ (backslash); in regular expressions
- * Character classes such as ``\w`` or ``\S`` (defined below) are also
accepted
- inside a set, although the characters they match depend on the flags_
used.
+ * Backslash either escapes characters which have special meaning in a set
+ such as ``'-'``, ``']'``, ``'^'`` and ``'\\'`` itself or signals
+ a special sequence which represents a single character such as
+ ``\xa0`` or ``\n`` or a character class such as ``\w`` or ``\S``
+ (defined below).
+ Note that ``\b`` represents a single "backspace" character,
+ not a word boundary as outside a set, and numeric escapes
+ such as ``\1`` are always octal escapes, not group references.
+ Special sequences which do not match a single character such as ``\A``
+ and ``\Z`` are not allowed.
.. index:: single: ^ (caret); in regular expressions
_______________________________________________
Python-checkins mailing list -- python-checkins@python.org
To unsubscribe send an email to python-checkins-le...@python.org
https://mail.python.org/mailman3/lists/python-checkins.python.org/
Member address: arch...@mail-archive.com
