From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Thu, 9 Apr 2026 13:40:28 +0000 (+0200)
Subject: [3.13] gh-106318: Add example for str.swapcase() method (GH-144575) (#148297)
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=8337805ad172c39eac4acc37527a01c35ea8361c;p=thirdparty%2FPython%2Fcpython.git

[3.13] gh-106318: Add example for str.swapcase() method (GH-144575) (#148297)

Co-authored-by: Adorilson Bezerra <adorilson@gmail.com>
---

diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst
index 95d281811bed..13275dc760f8 100644
--- a/Doc/library/stdtypes.rst
+++ b/Doc/library/stdtypes.rst
@@ -2620,8 +2620,22 @@ expression support in the :mod:`re` module).
 .. method:: str.swapcase()
 
    Return a copy of the string with uppercase characters converted to lowercase and
-   vice versa. Note that it is not necessarily true that
-   ``s.swapcase().swapcase() == s``.
+   vice versa. For example:
+
+   .. doctest::
+
+      >>> 'Hello World'.swapcase()
+      'hELLO wORLD'
+
+   Note that it is not necessarily true that ``s.swapcase().swapcase() == s``.
+   For example:
+
+   .. doctest::
+
+      >>> 'straße'.swapcase().swapcase()
+      'strasse'
+
+   See also :meth:`str.lower` and :meth:`str.upper`.
 
 
 .. method:: str.title()