summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorachhina <amanschhina@gmail.com>2023-06-07 02:01:36 (GMT)
committerGitHub <noreply@github.com>2023-06-07 02:01:36 (GMT)
commit3e7316d7e8969febb56fbc7416d483b073bd1702 (patch)
treea7af65df36e1cf30927ac47b946ae7453b971a1f /Doc
parent9a89f1bf1e7bb819fe7240be779c99a84f47ea46 (diff)
downloadcpython-3e7316d7e8969febb56fbc7416d483b073bd1702.zip
cpython-3e7316d7e8969febb56fbc7416d483b073bd1702.tar.gz
cpython-3e7316d7e8969febb56fbc7416d483b073bd1702.tar.bz2
GH-95088: Clarify rules for parsing an item key for format strings (#103779)
Co-authored-by: Ɓukasz Langa <lukasz@langa.pl> Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
Diffstat (limited to 'Doc')
-rw-r--r--Doc/library/string.rst4
1 files changed, 3 insertions, 1 deletions
diff --git a/Doc/library/string.rst b/Doc/library/string.rst
index 26b3f50..9b28f99 100644
--- a/Doc/library/string.rst
+++ b/Doc/library/string.rst
@@ -227,7 +227,9 @@ See also the :ref:`formatspec` section.
The *field_name* itself begins with an *arg_name* that is either a number or a
keyword. If it's a number, it refers to a positional argument, and if it's a keyword,
-it refers to a named keyword argument. If the numerical arg_names in a format string
+it refers to a named keyword argument. An *arg_name* is treated as a number if
+a call to :meth:`str.isdecimal` on the string would return true.
+If the numerical arg_names in a format string
are 0, 1, 2, ... in sequence, they can all be omitted (not just some)
and the numbers 0, 1, 2, ... will be automatically inserted in that order.
Because *arg_name* is not quote-delimited, it is not possible to specify arbitrary