From b87f82f8d46c8cd0fd4ab60f9680ca51ad3345bc Mon Sep 17 00:00:00 2001 From: Ezio Melotti Date: Sun, 4 Nov 2012 06:59:22 +0200 Subject: [PATCH] #16304: clarify match objects docs. Initial patch by Jan Duzinkiewicz. --- Doc/library/re.rst | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/Doc/library/re.rst b/Doc/library/re.rst index 8397aad1cf9..26f2a3824ea 100644 --- a/Doc/library/re.rst +++ b/Doc/library/re.rst @@ -814,9 +814,16 @@ attributes: Match Objects ------------- -Match objects always have a boolean value of :const:`True`. This lets you -use a simple if-statement to test whether a match was found. Match objects -support the following methods and attributes: +Match objects always have a boolean value of ``True``. +Since :meth:`~regex.match` and :meth:`~regex.search` return ``None`` +when there is no match, you can test whether there was a match with a simple +``if`` statement:: + + match = re.search(pattern, string) + if match: + process(match) + +Match objects support the following methods and attributes: .. method:: match.expand(template)