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.