Mirror
/
cpython
mirror of https://github.com/python/cpython
4
1
Fork 0
Code Issues Releases Wiki Activity

Issue #12644: document the '%a' conversion in the old string formatting operations. Patch prepared together with Ezio Melotti

This commit is contained in:
Eli Bendersky 2011-07-29 09:30:42 +03:00
parent 7c9719cf74
commit ef4902af87
1 changed files with 6 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
Doc/library/stdtypes.rst
View File

@ -1464,7 +1464,7 @@ components, which must occur in this order:
object to convert comes after the minimum field width and optional precision. object to convert comes after the minimum field width and optional precision.
#. Precision (optional), given as a ``'.'`` (dot) followed by the precision. If #. Precision (optional), given as a ``'.'`` (dot) followed by the precision. If
specified as ``'*'`` (an asterisk), the actual width is read from the next specified as ``'*'`` (an asterisk), the actual precision is read from the next
element of the tuple in *values*, and the value to convert comes after the element of the tuple in *values*, and the value to convert comes after the
precision. precision.
@ -1546,9 +1546,12 @@ The conversion types are:
| ``'r'`` | String (converts any Python object using | \(5) | | ``'r'`` | String (converts any Python object using | \(5) |
| | :func:`repr`). | | | | :func:`repr`). | |
+------------+-----------------------------------------------------+-------+ +------------+-----------------------------------------------------+-------+
| ``'s'`` | String (converts any Python object using | | | ``'s'`` | String (converts any Python object using | \(5) |
| | :func:`str`). | | | | :func:`str`). | |
+------------+-----------------------------------------------------+-------+ +------------+-----------------------------------------------------+-------+
| ``'a'`` | String (converts any Python object using | \(5) |
| | :func:`ascii`). | |
+------------+-----------------------------------------------------+-------+
| ``'%'`` | No argument is converted, results in a ``'%'`` | | | ``'%'`` | No argument is converted, results in a ``'%'`` | |
| | character in the result. | | | | character in the result. | |
+------------+-----------------------------------------------------+-------+ +------------+-----------------------------------------------------+-------+
@ -1581,7 +1584,7 @@ Notes:
decimal point and defaults to 6. decimal point and defaults to 6.
(5) (5)
The precision determines the maximal number of characters used. If precision is ``N``, the output is truncated to ``N`` characters.
(7) (7)