From a6de52c74d831e45ee0ff105196da8a58b9e43cd Mon Sep 17 00:00:00 2001 From: josh Date: Wed, 17 Apr 2019 22:43:30 +0000 Subject: bpo-32913: Added re.Match.groupdict example to regex HOWTO (GH-5821) --- Doc/howto/regex.rst | 7 +++++++ .../next/Documentation/2018-02-22-15-48-16.bpo-32913.f3utho.rst | 1 + 2 files changed, 8 insertions(+) create mode 100644 Misc/NEWS.d/next/Documentation/2018-02-22-15-48-16.bpo-32913.f3utho.rst diff --git a/Doc/howto/regex.rst b/Doc/howto/regex.rst index d385d99..d574c37 100644 --- a/Doc/howto/regex.rst +++ b/Doc/howto/regex.rst @@ -942,6 +942,13 @@ given numbers, so you can retrieve information about a group in two ways:: >>> m.group(1) 'Lots' +Additionally, you can retrieve named groups as a dictionary with +:meth:`~re.Match.groupdict`:: + + >>> m = re.match(r'(?P\w+) (?P\w+)', 'Jane Doe') + >>> m.groupdict() + {'first': 'Jane', 'last': 'Doe'} + Named groups are handy because they let you use easily-remembered names, instead of having to remember numbers. Here's an example RE from the :mod:`imaplib` module:: diff --git a/Misc/NEWS.d/next/Documentation/2018-02-22-15-48-16.bpo-32913.f3utho.rst b/Misc/NEWS.d/next/Documentation/2018-02-22-15-48-16.bpo-32913.f3utho.rst new file mode 100644 index 0000000..caa9590 --- /dev/null +++ b/Misc/NEWS.d/next/Documentation/2018-02-22-15-48-16.bpo-32913.f3utho.rst @@ -0,0 +1 @@ +Added re.Match.groupdict example to regex HOWTO. -- cgit v0.12