traverseda
/
cpython
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Issue #14123: Explicitly mention that old style % string formatting has caveats but is not going away any time soon.

This commit is contained in:
Gregory P. Smith 2012-02-26 01:54:46 -08:00
parent ab7bf2143e 3bbdc8e822
commit c45a8a153b
1 changed files with 7 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
Doc/library/stdtypes.rst
View File

@ -1466,8 +1466,13 @@ Old String Formatting Operations
.. note:: .. note::
The formatting operations described here are obsolete and may go away in future The formatting operations described here are modelled on C's printf()
versions of Python. Use the new :ref:`string-formatting` in new code. syntax. They only support formatting of certain builtin types. The
use of a binary operator means that care may be needed in order to
format tuples and dictionaries correctly. As the new
:ref:`string-formatting` syntax is more flexible and handles tuples and
dictionaries naturally, it is recommended for new code. However, there
are no current plans to deprecate printf-style formatting.
String objects have one unique built-in operation: the ``%`` operator (modulo). String objects have one unique built-in operation: the ``%`` operator (modulo).
This is also known as the string *formatting* or *interpolation* operator. This is also known as the string *formatting* or *interpolation* operator.