From: Adorilson Bezerra Date: Sun, 31 Mar 2024 22:34:54 +0000 (+0100) Subject: Doc: printf-style library/stdtype improvements (#16741) X-Git-Tag: v3.13.0a6~94 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=56e99307c49adcc6df355f8070229371c97d654f;p=thirdparty%2FPython%2Fcpython.git Doc: printf-style library/stdtype improvements (#16741) --- diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst index c963519f164d..62fc10997fc5 100644 --- a/Doc/library/stdtypes.rst +++ b/Doc/library/stdtypes.rst @@ -2339,7 +2339,13 @@ String objects have one unique built-in operation: the ``%`` operator (modulo). This is also known as the string *formatting* or *interpolation* operator. Given ``format % values`` (where *format* is a string), ``%`` conversion specifications in *format* are replaced with zero or more elements of *values*. -The effect is similar to using the :c:func:`sprintf` in the C language. +The effect is similar to using the :c:func:`sprintf` function in the C language. +For example: + +.. doctest:: + + >>> print('%s has %d quote types.' % ('Python', 2)) + Python has 2 quote types. If *format* requires a single argument, *values* may be a single non-tuple object. [5]_ Otherwise, *values* must be a tuple with exactly the number of