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

CKTIS / Python

Literal de cadeia de caracteres em bruto `r'...'` em Python

O prefixo `r` preserva as barras invertidas no valor da cadeia de caracteres. Numa expressão regular, é assim o módulo `re` que as interpreta.

Versão: Python 3.12

Sintaxe

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

Escreve r ou R imediatamente antes das aspas de abertura, sejam elas simples, duplas ou triplas. O resultado é um str normal: o prefixo altera a forma como o literal é lido, não o tipo do valor. 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 cria primeiro a cadeia de caracteres e, depois, re interpreta-a como um padrão. r'\d+' e '\\d+' produzem o mesmo padrão, que corresponde a um ou mais algarismos decimais. Em Python 3.12, escrever '\d' sem o prefixo gera um SyntaxWarning: \d é válido num padrão, mas não é uma sequência de escape reconhecida num literal comum do Python. Em re.sub, a cadeia de substituição tem regras próprias: \g<0> representa a correspondência completa, mesmo quando a substituição é escrita como um literal em bruto.

Uma barra invertida pode impedir que uma aspa feche o literal em bruto, mas a barra continua a fazer parte do valor. Um número ímpar de barras invertidas consecutivas imediatamente antes do delimitador de fecho torna o literal inválido e provoca um SyntaxError. Para acrescentares uma única barra invertida no fim, escreve, por exemplo, r'texto' + '\\'.

Exemplos

import re

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

Resultado

2 1
True
A[12] B[3]

A primeira linha mostra os dois comprimentos. A segunda confirma que as cadeias que representam o padrão são iguais. A terceira mostra como `re.sub` coloca cada sequência de algarismos entre parênteses retos.

Lições relacionadas

  • Python · Lição 29 · Intermédio · Versão: 3
  • Python · Lição 30 · Intermédio · Versão: 3
  • Python · Lição 34 · Intermédio · Versão: 3

Fontes