Método sub do módulo re

O método sub do módulo re realiza a busca e substituição de partes de uma string. O primeiro parâmetro recebe uma expressão regular, e o segundo - a substring pela qual substituímos. 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. E no quinto parâmetro opcional, especificamos sinalizadores para configurações adicionais de expressões regulares.

Sintaxe

import re

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

Exemplo

Vamos encontrar e substituir o caractere 'a':

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

print(res)

Resultado da execução do código:

'b!b'

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.sub('a', '!', txt)

print(res)

Resultado da execução do código:

'b!!!b'

Exemplo

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

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

print(res)

Resultado da execução do código:

'b!!ab'

Veja também

método subn do módulo re,
que retorna uma tupla contendo a string substituída e o número de substituições
método findall do módulo re,
que retorna uma lista com todas as correspondências na 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