From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Sat, 28 May 2022 18:28:52 +0000 (-0700)
Subject: gh-92727: Add example of named group in doc for re.Match.__getitem__ (GH-92730)
X-Git-Tag: v3.11.0b2~7
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=48647d00bf9c8ddfa1ace239de1c1b3943c43211;p=thirdparty%2FPython%2Fcpython.git

gh-92727: Add example of named group in doc for re.Match.__getitem__ (GH-92730)

(cherry picked from commit 642d1fa81fed8ac260e1719013d77b9dfd93920f)

Co-authored-by: Baptiste Mispelon <bmispelon@gmail.com>
---

diff --git a/Doc/library/re.rst b/Doc/library/re.rst
index 2af86d22d459..2392785d6c46 100644
--- a/Doc/library/re.rst
+++ b/Doc/library/re.rst
@@ -1324,6 +1324,14 @@ Match objects support the following methods and attributes:
       >>> m[2]       # The second parenthesized subgroup.
       'Newton'
 
+   Named groups are supported as well::
+
+      >>> m = re.match(r"(?P<first_name>\w+) (?P<last_name>\w+)", "Isaac Newton")
+      >>> m['first_name']
+      'Isaac'
+      >>> m['last_name']
+      'Newton'
+
    .. versionadded:: 3.6