Método subn del módulo re

El método subn del módulo re realiza búsqueda y reemplazo de partes de una cadena. Este método devuelve una tupla de la nueva cadena y el número de sustituciones realizadas. El primer parámetro acepta una expresión regular, y el segundo - la subcadena de reemplazo. En el tercer parámetro especificamos la cadena en la que realizar el reemplazo. En el cuarto parámetro opcional establecemos el número de sustituciones. En el quinto parámetro opcional especificamos banderas para configuraciones adicionales de expresiones regulares.

Sintaxis

import re

re.subn(expresión_regular, reemplazo, cadena, [número_sustituciones], [banderas])

Ejemplo

Busquemos y reemplacemos el carácter 'a':

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

print(res)

Resultado de ejecutar el código:

('b!b', 1)

Ejemplo

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

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

print(res)

Resultado de ejecutar el código:

('b!!!b', 3)

Ejemplo

Ahora realicemos solo dos sustituciones en la cadena:

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

print(res)

Resultado de ejecutar el código:

('b!!ab', 2)

Véase también

método sub del módulo re,
que realiza búsqueda y reemplazo de partes de cadena
método findall del módulo re,
que devuelve una lista de todas las coincidencias en una cadena
método finditer del módulo re,
que devuelve un iterador de todas las coincidencias con la expresión regular en una cadena
método search del módulo re,
que busca la primera coincidencia con la expresión regular en una cadena
método match del módulo re,
que busca coincidencia con la expresión regular al inicio de la cadena
método fullmatch del módulo re,
que busca todas las coincidencias con la expresión regular en una cadena