Método subn do módulo re

O método subn do módulo re realiza a busca e substituição de partes de uma string. Este método retorna uma tupla contendo a nova string e o número de substituições realizadas nela. O primeiro parâmetro aceita uma expressão regular, e o segundo - a substring pela qual substituir. No terceiro parâmetro, especificamos a string na qual a substituição deve ser feita. No quarto parâmetro opcional, definimos o número de substituições. No quinto parâmetro opcional, especificamos sinalizadores para configurações adicionais das expressões regulares.

Sintaxe

import re

re.subn(expressão_regular, substituição, string, [número_de_substituições], [sinalizadores])

Exemplo

Vamos encontrar e substituir o caractere 'a':

txt = 'bab'
res = re.subn('a', '!', txt)

print(res)

Resultado da execução do código:

('b!b', 1)

Exemplo

Por padrão, todas as correspondências encontradas são substituídas. Vamos substituir novamente o caractere 'a' na string:

txt = 'baaab'
res = re.subn('a', '!', txt)

print(res)

Resultado da execução do código:

('b!!!b', 3)

Exemplo

Agora vamos fazer apenas duas substituições na string:

txt = 'baaab'
res = re.subn('a', '!', txt, 2)

print(res)

Resultado da execução do código:

('b!!ab', 2)

Veja também

método sub do módulo re,
que realiza busca e substituição de partes de string
método findall do módulo re,
que retorna uma lista com todas as correspondências em uma string
método finditer do módulo re,
que retorna um iterador de todas as correspondências com a expressão regular na string
método search do módulo re,
que busca a primeira correspondência com a expressão regular na string
método match do módulo re,
que busca correspondência com a expressão regular no início da string
método fullmatch do módulo re,
que busca todas as correspondências com a expressão regular na string