Método sub del módulo re

El método sub del módulo re realiza la búsqueda y reemplazo de partes de una cadena. El primer parámetro acepta una expresión regular, y el segundo, una subcadena por la cual reemplazar. En el tercer parámetro se especifica la cadena en la que se debe realizar el reemplazo. En el cuarto parámetro opcional se establece la cantidad de reemplazos. Y en el quinto parámetro opcional se especifican banderas para configuraciones adicionales de las expresiones regulares.

Sintaxis

import re

re.sub(expresión_regular, reemplazo, cadena, [cantidad de reemplazos], [banderas])

Ejemplo

Busquemos y reemplacemos el carácter 'a':

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

print(res)

Resultado de la ejecución del código:

'b!b'

Ejemplo

Por defecto, se reemplazan todas las coincidencias encontradas. Reemplacemos nuevamente el carácter 'a' en la cadena:

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

print(res)

Resultado de la ejecución del código:

'b!!!b'

Ejemplo

Y ahora hagamos sólo dos reemplazos en la cadena:

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

print(res)

Resultado de la ejecución del código:

'b!!ab'

Véase también

método subn del módulo re,
que devuelve una tupla con la cadena modificada y el número de reemplazos
método findall del módulo re,
que devuelve una lista con todas las coincidencias en la cadena
método finditer del módulo re,
que devuelve un iterador de todas las coincidencias con la expresión regular en la cadena
método search del módulo re,
que busca la primera coincidencia con la expresión regular en la cadena
método match del módulo re,
que busca coincidencia con la expresión regular al principio de la cadena
método fullmatch del módulo re,
que busca todas las coincidencias con la expresión regular en la cadena