cpython: e3ff2065c548 (original) (raw)
Mercurial > cpython
changeset 86526:e3ff2065c548 3.3
#19238, #19289: fix description of the align and fill values of the format specification. [#19238]
| Ezio Melotti ezio.melotti@gmail.com | |
|---|---|
| date | Mon, 21 Oct 2013 02:53:07 +0300 |
| parents | 849ed3ea215b |
| children | f52892642c15 10a261824b62 |
| files | Doc/library/string.rst |
| diffstat | 1 files changed, 6 insertions(+), 6 deletions(-)[+] [-] Doc/library/string.rst 12 |
line wrap: on
line diff
--- a/Doc/library/string.rst
+++ b/Doc/library/string.rst
@@ -293,18 +293,18 @@ The general form of a *standard format s
.. productionlist:: sf
format_spec: [[fill]align][sign][#][0][width][,][.precision][type]
- fill:
align: "<" | ">" | "=" | "^"
sign: "+" | "-" | " "
width:
integerprecision:integertype: "b" | "c" | "d" | "e" | "E" | "f" | "F" | "g" | "G" | "n" | "o" | "s" | "x" | "X" | "%"
-The fill character can be any character other than '{' or '}'. The presence
-of a fill character is signaled by the character following it, which must be
-one of the alignment options. If the second character of format_spec is not
-a valid alignment option, then it is assumed that both the fill character and
-the alignment option are absent.
+If a valid align value is specified, it can be preceeded by a fill
+character that can be any character and defaults to a space if omitted.
+Note that it is not possible to use { and } as fill char while
+using the :meth:str.format method; this limitation however doesn't
+affect the :func:format function.
The meaning of the various alignment options is as follows: