traverseda
/
cpython
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Improve the F-strings and format specifier documentation (GH-4931) (GH-4933) 

Mention that the format-specifier mini language in f-strings
is the same one used by str.format.
(cherry picked from commit f4e21a2a72)
This commit is contained in:
Miss Islington (bot) 2017-12-19 13:09:19 -08:00 committed by Mariatta
parent dc5770b161
commit 75d1ca26b0
1 changed files with 5 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
Doc/reference/lexical_analysis.rst
View File

@ -654,10 +654,11 @@ expression or conversion result. An empty string is passed when the
format specifier is omitted. The formatted result is then included in format specifier is omitted. The formatted result is then included in
the final value of the whole string. the final value of the whole string.
Top-level format specifiers may include nested replacement fields. Top-level format specifiers may include nested replacement fields. These nested
These nested fields may include their own conversion fields and fields may include their own conversion fields and :ref:`format specifiers
:ref:`format specifiers <formatspec>`, but may not include more <formatspec>`, but may not include more deeply-nested replacement fields. The
deeply-nested replacement fields. :ref:`format specifier mini-language <formatspec>` is the same as that used by
the string .format() method.
Formatted string literals may be concatenated, but replacement fields Formatted string literals may be concatenated, but replacement fields
cannot be split across literals. cannot be split across literals.