Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Python

Literais de cadeia sem processamento em Python: o prefixo r

O prefixo `r` preserva as barras invertidas num literal `str`. Assim, os padrões de expressões regulares tornam-se mais legíveis, sem mudar a forma como `re` os interpreta.

Versão: Python 3.12

Sintaxe

r"...", r'...', R"...", R'...'; triple-quoted forms: r"""...""" and r'''...''' (also with uppercase R)

Coloca r ou R imediatamente antes da aspa de abertura de um literal de cadeia. Podes usar aspas simples, duplas ou triplas. O resultado continua a ser um str normal: r"\n" contém dois caracteres, uma barra invertida e n, enquanto "\n" contém um único carácter de mudança de linha.

O Python constrói primeiro a cadeia e só depois re a interpreta como padrão. Assim, r"\d+" corresponde a um ou mais algarismos decimais Unicode, e não ao texto literal \d+. O literal normal "\\d+" produz o mesmo padrão. No Python 3.12, escrever "\d+" com uma só barra invertida gera um SyntaxWarning, porque \d não é uma sequência de escape reconhecida nos literais de cadeia do Python.

Uma barra invertida pode impedir que uma aspa do mesmo tipo feche o literal, mas permanece no resultado. Um número ímpar de barras invertidas imediatamente antes do delimitador de fecho é inválido e provoca um SyntaxError. O prefixo r só atua em literais do código-fonte. Para incluir num padrão texto recebido durante a execução e procurar uma correspondência literal, usa re.escape(text).

Exemplos

import re

pattern = r"item-\d+"
print(len(r"\n"), len("\n"))
print(pattern == "item-\\d+")
print(re.fullmatch(pattern, "item-42") is not None)
print(re.fullmatch(pattern, "item-42x") is not None)

Resultado

2 1
True
True
False

A primeira linha compara os comprimentos e a segunda confirma que os padrões são iguais. `re.fullmatch` verifica a cadeia inteira: `item-42` corresponde, mas `item-42x` não.

Lições relacionadas

  • Python · Lição 34 · Avançado · Versão: 5

Fontes