The text about escaping newlines in triple-qouted strings is misleading
Maintainer antworten meist innerhalb von 1 Tag
Dieses Issue hat noch niemand übernommen.
Bewertung
- Schwierigkeit
- 1/5
- Geschätzter Aufwand
- Unter einer Stunde
- Anfängerfreundlichkeit
- 1/100
- Issue-Typ
- Dokumentation
- Klarheit
- Klar beschrieben
- Aktivitätsstatus
- Veraltet
- Tech-Stack
- python
- Bereich
- documentation
Rechercherichtung
Read section 2.5.4.1 of the lexical analysis documentation at docs.python.org/3.16/reference/lexical_analysis.html#string-escape-ignore. Clarify that unescaped newlines in triple-quoted strings are retained and that omitting a newline requires a backslash-newline escape in both single- and triple-quoted strings. Check the wording against the examples in that section; the issue says the reporter is creating a PR and lists linked PR #160887.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Beschreibung
Documentation
File: https://docs.python.org/3.16/reference/lexical_analysis.html#string-escape-ignore
Section 2.5.4.1 says:
A backslash can be added at the end of a line to ignore the newline:
(code sample)
The same result can be achieved using triple-quoted strings, or parentheses and string literal concatenation.
The current wording suggests that triple-quoted strings alone can split text across source lines without preserving newlines. In fact, unescaped newlines are retained, and omitting them requires the same backslash-newline escape used in ordinary string literals.
I suggest improving the text and clarifying that escaping newlines works the same in single- or triple-qouted string.
I'm creating the PR.
Linked PRs
- gh-160887
- Vorherrschende Sprache
- Python
- Sterne
- 77.8k
- Forks
- 37.7k
- Ø Merge
- 15 Std. 24 Min.
- Gemergte PRs (30 T.)
- 728
Entwicklungsumgebung
Startet den Dev-Container des Projekts im Browser, mit Ihrem eigenen GitHub-Konto.
- Kein Dockerfile und keine Docker-Compose-Datei
- Hat eine Pull-Request-Vorlage
- Beitragsleitfaden lesen
Erste Schritte
- Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
- Forken Sie das Repository und arbeiten Sie in einem Branch.
- Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.
Mehr aus python/cpython
-
What's New in 3.12 credits the unstable C API tier to PEP 697 instead of PEP 689Evtl. vergeben Ein verknüpfter Pull Request ist offen oder bereits gemergt. Offendocs
Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 82/100
python/cpython#161078 · 3 Kommentare ·
Maintainer antworten meist innerhalb von 1 Tag
-
OS-windows type-bug
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 68/100
Maintainer antworten meist innerhalb von 1 Tag
-
docs
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 72/100
python/cpython#161007 · 2 Kommentare ·
Maintainer antworten meist innerhalb von 1 Tag
-
Null dereferencing of a pointer in initconfig.cEvtl. vergeben @lazerg hat das vor 3 Tagen übernommen. Offeninterpreter-core topic-C-API type-bug
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 72/100
python/cpython#160962 · 4 Kommentare ·
Maintainer antworten meist innerhalb von 1 Tag
-
tests topic-profiling type-bug
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 76/100
python/cpython#160881 · 1 Kommentar ·
Maintainer antworten meist innerhalb von 1 Tag
Ähnliche Issues
-
URLValidator ignores an explicit empty scheme allowlistEvtl. vergeben @IlyaKhalafi hat das heute übernommen. Offen
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 85/100
tortoise/tortoise-orm#2393 ·
Maintainer antworten meist innerhalb von 2 Tagen
-
bug
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 62/100
frappe/frappe_docker#2046 ·
Maintainer antworten meist innerhalb von 1 Tag
-
Weekly link check failedOffen
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 62/100
-
complete_box_iou_loss / complete_box_iou: NaN gradients for zero-height boxes, NaN for point boxesOffen
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 62/100
Maintainer antworten meist innerhalb von 1 Tag
-
AXI SMU SPEC
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 62/100
tenstorrent/tt-oca-harness#3556 ·
Maintainer antworten meist innerhalb von 1 Tag