diff options
author | Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> | 2022-05-16 16:54:40 (GMT) |
---|---|---|
committer | GitHub <noreply@github.com> | 2022-05-16 16:54:40 (GMT) |
commit | 006b302beb68a7b3cee11e34dcee3c20673b5399 (patch) | |
tree | 5fabfb37bdb44bad335f7aa982d47c28f115bfcd | |
parent | e29ce9a5f111270163a047b50ea55af6cad89838 (diff) | |
download | cpython-006b302beb68a7b3cee11e34dcee3c20673b5399.zip cpython-006b302beb68a7b3cee11e34dcee3c20673b5399.tar.gz cpython-006b302beb68a7b3cee11e34dcee3c20673b5399.tar.bz2 |
gh-80143: Add clarification for escape characters (GH-92292) (GH-92629)
(cherry picked from commit 549567c6e70da4846c105a18a1a89e7dd09680d7)
Co-authored-by: slateny <46876382+slateny@users.noreply.github.com>
-rw-r--r-- | Doc/reference/lexical_analysis.rst | 10 |
1 files changed, 7 insertions, 3 deletions
diff --git a/Doc/reference/lexical_analysis.rst b/Doc/reference/lexical_analysis.rst index d9e2cea..0dad31f 100644 --- a/Doc/reference/lexical_analysis.rst +++ b/Doc/reference/lexical_analysis.rst @@ -480,9 +480,11 @@ declaration is given in the source file; see section :ref:`encodings`. In plain English: Both types of literals can be enclosed in matching single quotes (``'``) or double quotes (``"``). They can also be enclosed in matching groups of three single or double quotes (these are generally referred to as -*triple-quoted strings*). The backslash (``\``) character is used to escape -characters that otherwise have a special meaning, such as newline, backslash -itself, or the quote character. +*triple-quoted strings*). The backslash (``\``) character is used to give special +meaning to otherwise ordinary characters like ``n``, which means 'newline' when +escaped (``\n``). It can also be used to escape characters that otherwise have a +special meaning, such as newline, backslash itself, or the quote character. +See :ref:`escape sequences <escape-sequences>` below for examples. .. index:: single: b'; bytes literal @@ -541,6 +543,8 @@ retained), except that three unescaped quotes in a row terminate the literal. ( single: \u; escape sequence single: \U; escape sequence +.. _escape-sequences: + Unless an ``'r'`` or ``'R'`` prefix is present, escape sequences in string and bytes literals are interpreted according to rules similar to those used by Standard C. The recognized escape sequences are: |