From 17bf91dfd6f3f80555e3f26338e889fdc7811c02 Mon Sep 17 00:00:00 2001 From: Adorilson Bezerra Date: Sat, 27 Feb 2021 20:27:04 -0300 Subject: [PATCH] gh-106318: Add examples for str.casefold() and str.lower() methods --- Doc/library/stdtypes.rst | 16 ++++++++++++++-- 1 file changed, 14 insertions(+), 2 deletions(-) diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst index 8b896011734df5..28129a66ff9431 100644 --- a/Doc/library/stdtypes.rst +++ b/Doc/library/stdtypes.rst @@ -1841,7 +1841,14 @@ expression support in the :mod:`re` module). intended to remove all case distinctions in a string. For example, the German lowercase letter ``'ß'`` is equivalent to ``"ss"``. Since it is already lowercase, :meth:`lower` would do nothing to ``'ß'``; :meth:`casefold` - converts it to ``"ss"``. + converts it to ``"ss"``, as follows: + + .. doctest:: + + >>> 'ß'.casefold() + 'ss' + >>> 'ß'.lower() + 'ß' The casefolding algorithm is `described in section 3.13.3 'Default Case Folding' of the Unicode Standard @@ -2250,7 +2257,12 @@ expression support in the :mod:`re` module). .. method:: str.lower() Return a copy of the string with all the cased characters [4]_ converted to - lowercase. + lowercase. For example: + + .. doctest:: + + >>> 'Lower Method Example'.lower() + 'lower method example' The lowercasing algorithm used is `described in section 3.13.2 'Default Case Conversion' of the Unicode Standard