diff options
| author | Ezio Melotti <ezio.melotti@gmail.com> | 2013-10-21 02:53:07 +0300 |
|---|---|---|
| committer | Ezio Melotti <ezio.melotti@gmail.com> | 2013-10-21 02:53:07 +0300 |
| commit | c31844257185f897d657bb8929f36f9c4e8888f2 (patch) | |
| tree | 3abd0035e258889d69e5d83ff444b513b7e9b581 /Doc/library/string.rst | |
| parent | 6e9e4fe97c7b86eb7a1fa766cd81b5b1d84b3aea (diff) | |
| download | cpython-git-c31844257185f897d657bb8929f36f9c4e8888f2.tar.gz | |
#19238, #19289: fix description of the align and fill values of the format specification.
Diffstat (limited to 'Doc/library/string.rst')
| -rw-r--r-- | Doc/library/string.rst | 12 |
1 files changed, 6 insertions, 6 deletions
diff --git a/Doc/library/string.rst b/Doc/library/string.rst index c92a005aac..e304c5d4ff 100644 --- a/Doc/library/string.rst +++ b/Doc/library/string.rst @@ -293,18 +293,18 @@ The general form of a *standard format specifier* is: .. productionlist:: sf format_spec: [[`fill`]`align`][`sign`][#][0][`width`][,][.`precision`][`type`] - fill: <a character other than '{' or '}'> + fill: <any character> align: "<" | ">" | "=" | "^" sign: "+" | "-" | " " width: `integer` precision: `integer` type: "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: |