Stowage/cpython
2
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2026-06-18 15:42:21 +00:00
Code Issues Projects Releases Packages Wiki Activity

[3.14] gh-134887: Add references to locale module for locale-aware number formatting references in string module docs (GH-134888) (GH-150121)

Browse source 
(cherry picked from commit 47723af4e7)

Co-authored-by: Stefanie Molin <24376333+stefmolin@users.noreply.github.com>
This commit is contained in:
Miss Islington (bot) 2026-05-20 02:55:14 +02:00 • committed by GitHub
parent 2744371e4f
commit accfbb693f
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 18 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

24
Doc/library/string.rst
View file

@ -472,7 +472,9 @@ of a number respectively. It can be one of the following:
| | this option is not supported. |
+---------+----------------------------------------------------------+
For a locale aware separator, use the ``'n'`` presentation type instead.
For a locale-aware separator, use the ``'n'``
:ref:`float presentation type <n-format-float>` or
:ref:`integer presentation type <n-format-integer>` instead.
.. versionchanged:: 3.1
Added the ``','`` option (see also :pep:`378`).
@ -518,9 +520,14 @@ The available integer presentation types are:
| | In case ``'#'`` is specified, the prefix ``'0x'`` will |
| | be upper-cased to ``'0X'`` as well. |
+---------+----------------------------------------------------------+
| ``'n'`` | Number. This is the same as ``'d'``, except that it uses |
| ``'n'`` | .. _n-format-integer: |
| | |
| | Number. This is the same as ``'d'``, except that it uses |
| | the current locale setting to insert the appropriate |
| | digit group separators. |
| | digit group separators. Note that the default locale is |
| | not the system locale. Depending on your use case, you |
| | may wish to set :const:`~locale.LC_NUMERIC` with |
| | :func:`locale.setlocale` before using ``'n'``. |
+---------+----------------------------------------------------------+
| None | The same as ``'d'``. |
+---------+----------------------------------------------------------+
@ -603,10 +610,15 @@ The available presentation types for :class:`float` and
| | ``'E'`` if the number gets too large. The |
| | representations of infinity and NaN are uppercased, too. |
+---------+----------------------------------------------------------+
| ``'n'`` | Number. This is the same as ``'g'``, except that it uses |
| ``'n'`` | .. _n-format-float: |
| | |
| | Number. This is the same as ``'g'``, except that it uses |
| | the current locale setting to insert the appropriate |
| | digit group separators |
| | for the integral part of a number. |
| | digit group separators for the integral part of a |
| | number. Note that the default locale is not the system |
| | locale. Depending on your use case, you may wish to set |
| | :const:`~locale.LC_NUMERIC` with |
| | :func:`locale.setlocale` before using ``'n'``. |
+---------+----------------------------------------------------------+
| ``'%'`` | Percentage. Multiplies the number by 100 and displays |
| | in fixed (``'f'``) format, followed by a percent sign. |