Kaydet (Commit) f66f03bd authored tarafından Jason R. Coombs's avatar Jason R. Coombs

Update docs to reflect new behavior around backslashes in expressions (not…

Update docs to reflect new behavior around backslashes in expressions (not allowed), matching recent changes to PEP 498.
üst 1c92a76a
...@@ -679,17 +679,22 @@ Some examples of formatted string literals:: ...@@ -679,17 +679,22 @@ Some examples of formatted string literals::
A consequence of sharing the same syntax as regular string literals is A consequence of sharing the same syntax as regular string literals is
that characters in the replacement fields must not conflict with the that characters in the replacement fields must not conflict with the
quoting used in the outer formatted string literal. Also, escape quoting used in the outer formatted string literal::
sequences normally apply to the outer formatted string literal,
rather than inner string literals::
f"abc {a["x"]} def" # error: outer string literal ended prematurely f"abc {a["x"]} def" # error: outer string literal ended prematurely
f"abc {a[\"x\"]} def" # workaround: escape the inner quotes
f"abc {a['x']} def" # workaround: use different quoting f"abc {a['x']} def" # workaround: use different quoting
f"newline: {ord('\n')}" # error: literal line break in inner string Backslashes are not allowed in format expressions and will raise
f"newline: {ord('\\n')}" # workaround: double escaping an error::
fr"newline: {ord('\n')}" # workaround: raw outer string
f"newline: {ord('\n')}" # raises SyntaxError
To include a value in which a backslash escape is required, create
a temporary variable.
>>> newline = ord('\n')
>>> f"newline: {newline}"
'newline: 10'
See also :pep:`498` for the proposal that added formatted string literals, See also :pep:`498` for the proposal that added formatted string literals,
and :meth:`str.format`, which uses a related format string mechanism. and :meth:`str.format`, which uses a related format string mechanism.
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment