From b66d46f0ca3a9399ee4b8bea75c3b5ab3110b35a Mon Sep 17 00:00:00 2001 From: Stevoisiak Date: Sat, 17 Feb 2024 03:33:28 -0500 Subject: [PATCH] gh-101699: Explain using Match.expand with \g<0> (GH-101701) Update documentation for re library to explain that a backreference `\g<0>` is expanded to the entire string when using Match.expand(). Note that numeric backreferences to group 0 (`\0`) are not supported. (cherry picked from commit d2d78088530433f475d9304104bbc0dac2536edd) Co-authored-by: Stevoisiak Co-authored-by: Serhiy Storchaka --- Doc/library/re.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/Doc/library/re.rst b/Doc/library/re.rst index 29d8067a585150..8bc1ec63213d12 100644 --- a/Doc/library/re.rst +++ b/Doc/library/re.rst @@ -1336,7 +1336,8 @@ when there is no match, you can test whether there was a match with a simple Escapes such as ``\n`` are converted to the appropriate characters, and numeric backreferences (``\1``, ``\2``) and named backreferences (``\g<1>``, ``\g``) are replaced by the contents of the - corresponding group. + corresponding group. The backreference ``\g<0>`` will be + replaced by the entire match. .. versionchanged:: 3.5 Unmatched groups are replaced with an empty string.