From b9753786bbcf11207b3c45b4c36d8e2a5ebc408b Mon Sep 17 00:00:00 2001 From: Adorilson Bezerra Date: Tue, 14 Oct 2025 11:19:27 -0300 Subject: [PATCH] gh-106318: Add examples for str.istitle() (GH-140046) (cherry picked from commit 07e617ecc274f21607320e68a7e8b09ee91f968b) Co-authored-by: Adorilson Bezerra --- Doc/library/stdtypes.rst | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst index aea73724ef56d6..a9658820f66eb9 100644 --- a/Doc/library/stdtypes.rst +++ b/Doc/library/stdtypes.rst @@ -2157,6 +2157,19 @@ expression support in the :mod:`re` module). character, for example uppercase characters may only follow uncased characters and lowercase characters only cased ones. Return ``False`` otherwise. + For example: + + .. doctest:: + + >>> 'Spam, Spam, Spam'.istitle() + True + >>> 'spam, spam, spam'.istitle() + False + >>> 'SPAM, SPAM, SPAM'.istitle() + False + + See also :meth:`title`. + .. method:: str.isupper() @@ -2534,6 +2547,8 @@ expression support in the :mod:`re` module). >>> titlecase("they're bill's friends.") "They're Bill's Friends." + See also :meth:`istitle`. + .. method:: str.translate(table, /)