Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Python

Surowy literał tekstowy `r'...'` w Pythonie

Prefiks `r` zachowuje ukośniki odwrotne w wartości tekstowej. To przydatne we wzorcach, w których te znaki ma zinterpretować moduł `re`, a nie Python podczas odczytywania literału.

Wersja: Python 3.12

Składnia

r'...' | r"..." | r'''...''' | r"""...""" (`R` can replace `r`; `...` stands for the literal contents.)

Umieść r lub R bezpośrednio przed pojedynczym, podwójnym lub potrójnym cudzysłowem otwierającym literał. Wynikiem jest zwykły str: prefiks zmienia zapis literału, a nie typ wartości. r'\n' zawiera dwa znaki — ukośnik odwrotny i n — natomiast '\n' zawiera jeden znak nowego wiersza.

Python najpierw tworzy łańcuch znaków, a dopiero potem re interpretuje go jako wzorzec. r'\d+' i '\\d+' dają ten sam wzorzec, który dopasowuje co najmniej jedną cyfrę dziesiętną. W Pythonie 3.12 zapis '\d' bez prefiksu powoduje ostrzeżenie SyntaxWarning: \d jest poprawne we wzorcu, ale Python nie rozpoznaje go jako sekwencji ucieczki w zwykłym literale. W re.sub obowiązują osobne reguły dla tekstu zastępującego: \g<0> w takim tekście oznacza całe dopasowanie, nawet jeśli zapisano go jako surowy literał.

Ukośnik odwrotny może sprawić, że pasujący cudzysłów nie zamknie surowego literału, ale sam ukośnik pozostaje w wartości. Bezpośrednio przed cudzysłowem zamykającym nie może stać nieparzysta liczba kolejnych ukośników odwrotnych: taki zapis powoduje SyntaxError. Aby dodać na końcu jeden ukośnik odwrotny, użyj na przykład r'tekst' + '\\'.

Przykłady

import re

print(len(r'\n'), len('\n'))
pattern = r'\d+'
print(pattern == '\\d+')
print(re.sub(pattern, r'[\g<0>]', 'A12 B3'))

Wynik

2 1
True
A[12] B[3]

Pierwszy wiersz pokazuje długości obu łańcuchów, drugi potwierdza równość wartości wzorców, a trzeci pokazuje, jak `re.sub` ujmuje każdy ciąg cyfr w nawiasy kwadratowe.

Powiązane lekcje

  • Python · Lekcja 29 · Średniozaawansowany · Wersja: 3
  • Python · Lekcja 30 · Średniozaawansowany · Wersja: 3
  • Python · Lekcja 34 · Średniozaawansowany · Wersja: 3

Źródła