Commit ef4902af authored by Eli Bendersky's avatar Eli Bendersky

Issue #12644: document the '%a' conversion in the old string formatting...

Issue #12644: document the '%a' conversion in the old string formatting operations. Patch prepared together with Ezio Melotti
parent 7c9719cf
...@@ -1464,7 +1464,7 @@ components, which must occur in this order: ...@@ -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: ...@@ -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: ...@@ -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)
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment