summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorÉric Araujo <merwok@netwok.org>2011-09-01 16:59:06 (GMT)
committerÉric Araujo <merwok@netwok.org>2011-09-01 16:59:06 (GMT)
commit29cf58c9d56ee488ab12ae0110baa900f36f6ec6 (patch)
tree3cf9e68abaf2b2284809402706edb241f3b9b19e /Doc
parent8ab3a1d7350b8fae8cf4ae4c726035152e3f59ab (diff)
downloadcpython-29cf58c9d56ee488ab12ae0110baa900f36f6ec6.zip
cpython-29cf58c9d56ee488ab12ae0110baa900f36f6ec6.tar.gz
cpython-29cf58c9d56ee488ab12ae0110baa900f36f6ec6.tar.bz2
Document that format string don’t support arbitrary dictonary keys.
Text adapted from the PEP. Addition requested by Terry J. Reedy on 2011-02-23 on python-dev.
Diffstat (limited to 'Doc')
-rw-r--r--Doc/library/string.rst2
1 files changed, 2 insertions, 0 deletions
diff --git a/Doc/library/string.rst b/Doc/library/string.rst
index 2443180..78f2b4d 100644
--- a/Doc/library/string.rst
+++ b/Doc/library/string.rst
@@ -216,6 +216,8 @@ keyword. If it's a number, it refers to a positional argument, and if it's a ke
it refers to a named keyword argument. 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
+dictionary keys (e.g., the strings ``'10'`` or ``':-]'``) within a format string.
The *arg_name* can be followed by any number of index or
attribute expressions. An expression of the form ``'.name'`` selects the named
attribute using :func:`getattr`, while an expression of the form ``'[index]'``