Skip to content

Commit

Permalink
Improve the F-strings and format specifier documentation (GH-4931) (G…
Browse files Browse the repository at this point in the history
…H-4933)

Mention that the format-specifier mini language in f-strings
is the same one used by str.format.
(cherry picked from commit f4e21a2)
  • Loading branch information
miss-islington authored and Mariatta committed Dec 19, 2017
1 parent dc5770b commit 75d1ca2
Showing 1 changed file with 5 additions and 4 deletions.
9 changes: 5 additions & 4 deletions Doc/reference/lexical_analysis.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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
the final value of the whole string.

Top-level format specifiers may include nested replacement fields.
These nested fields may include their own conversion fields and
:ref:`format specifiers <formatspec>`, but may not include more
deeply-nested replacement fields.
Top-level format specifiers may include nested replacement fields. These nested
fields may include their own conversion fields and :ref:`format specifiers
<formatspec>`, but may not include more deeply-nested replacement fields. The
: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
cannot be split across literals.
Expand Down

0 comments on commit 75d1ca2

Please sign in to comment.