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

CKTIS / Python

re.sub

Substitui da esquerda para a direita correspondências sem sobreposição.

Versão: Python 3.14; repository image, production runtime not attested

Sintaxe

re.sub(pattern, repl, string, count=0, flags=0)

Substitui da esquerda para a direita correspondências sem sobreposição.

No modelo uma sequência desconhecida de barra invertida e letra ASCII como \q gera re.PatternError. A mesma cadeia devolvida por uma função mantém-se literal. Uma cadeia repl é um modelo com possíveis referências a grupos, enquanto uma função recebe um Match e fornece diretamente a substituição. count=0 permite todas as substituições.

No exemplo count=1 limita o incremento ao primeiro número 3 e o resultado é x4 y7.

import re
assert re.sub(r"(\w+)=(\d+)", r"\2:\1", "x=3") == "3:x"
assert re.sub(r"\d+", lambda m: str(int(m[0]) + 1), "x3 y7", count=1) == "x4 y7"
assert re.sub("z", "x", "abc") == "abc"
try:
    re.sub("a", r"\q", "a")
except re.PatternError:
    pass
else:
    raise AssertionError
assert re.sub("a", lambda m: r"\q", "a") == r"\q"

Exemplos

import re
print(re.sub(r"\d+", lambda m: str(int(m.group()) + 1), "x3 y7", count=1))

Resultado

x4 y7

No exemplo count=1 limita o incremento ao primeiro número 3 e o resultado é x4 y7.

Fontes