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

CKTIS / Python

re.subn

Devolve um par com o texto transformado e o número de substituições.

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

Sintaxe

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

Devolve um par com o texto transformado e o número de substituições.

Tal como sub aceita um modelo com referências a grupos ou uma função para Match e o limite count. Trocar a por a em aba conserva o texto mas conta duas substituições.

O padrão ausente z dá o texto original e zero.

import re
s, n = re.subn("a", "a", "aba", count=1)
assert (s, n) == ("aba", 1)
assert re.subn(r"\d", lambda m: "#" * int(m[0]), "a2b1") == ("a##b#", 2)
assert re.subn("z", "x", "aba") == ("aba", 0)

Exemplos

import re
print(re.subn("a", "a", "aba"))
print(re.subn("z", "x", "aba"))

Resultado

('aba', 2)
('aba', 0)

O padrão ausente z dá o texto original e zero.

Fontes