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)