From: Andrew M. Kuchling Date: Mon, 5 Oct 2009 22:42:56 +0000 (+0000) Subject: Backport r73983: Document the thousands separator. X-Git-Tag: v2.7a1~412 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=fa6a4271c11ef8b62312b448b0053d694f05d95f;p=python Backport r73983: Document the thousands separator. --- diff --git a/Doc/library/string.rst b/Doc/library/string.rst index 9a13dc6667..f5a1a3e18f 100644 --- a/Doc/library/string.rst +++ b/Doc/library/string.rst @@ -325,7 +325,7 @@ result as if you had called :func:`str` on the value. The general form of a *standard format specifier* is: .. productionlist:: sf - format_spec: [[`fill`]`align`][`sign`][#][0][`width`][.`precision`][`type`] + format_spec: [[`fill`]`align`][`sign`][#][0][`width`][,][.`precision`][`type`] fill: align: "<" | ">" | "=" | "^" sign: "+" | "-" | " " @@ -383,6 +383,10 @@ The ``'#'`` option is only valid for integers, and only for binary, octal, or hexadecimal output. If present, it specifies that the output will be prefixed by ``'0b'``, ``'0o'``, or ``'0x'``, respectively. +The ``','`` option signals the use of a comma for a thousands separator. +For a locale aware separator, use the ``'n'`` integer presentation type +instead. + *width* is a decimal integer defining the minimum field width. If not specified, then the field width will be determined by the content.