From 82df8c3c0eaf72ac2e9abeae7d807d41fc44fa04 Mon Sep 17 00:00:00 2001 From: Adorilson Bezerra Date: Mon, 24 Nov 2025 14:51:10 +0000 Subject: [PATCH] gh-106318: Add example for str.format() (GH-137018) (cherry picked from commit 0cde70bde0e3c5310a9bac76db14481a8bf23ad6) Co-authored-by: Adorilson Bezerra --- Doc/library/stdtypes.rst | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst index b942118d67fb9b..101294ce392464 100644 --- a/Doc/library/stdtypes.rst +++ b/Doc/library/stdtypes.rst @@ -1858,10 +1858,16 @@ expression support in the :mod:`re` module). ``{}``. Each replacement field contains either the numeric index of a positional argument, or the name of a keyword argument. Returns a copy of the string where each replacement field is replaced with the string value of - the corresponding argument. + the corresponding argument. For example: + + .. doctest:: >>> "The sum of 1 + 2 is {0}".format(1+2) 'The sum of 1 + 2 is 3' + >>> "The sum of {a} + {b} is {answer}".format(answer=1+2, a=1, b=2) + 'The sum of 1 + 2 is 3' + >>> "{1} expects the {0} Inquisition!".format("Spanish", "Nobody") + 'Nobody expects the Spanish Inquisition!' See :ref:`formatstrings` for a description of the various formatting options that can be specified in format strings.