CKTIS / Python
Sustituir coincidencias de una expresión regular compilada con re.Pattern.sub
Llama a `sub()` sobre una expresión regular compilada para sustituir coincidencias con una plantilla o con el resultado de una función. Limita el número de sustituciones con `count`.
Versión: Python 3.12
Sintaxis
pattern = re.compile(regex, flags=0)
pattern.sub(repl, string, count=0)En Python 3.12, re.Pattern.sub es un método del objeto que devuelve re.compile(). Llámalo como pattern.sub(repl, string, count=0). A diferencia de la función del módulo re.sub(), el método no recibe un patrón por separado ni un argumento flags: usa el patrón y las opciones almacenados en el objeto. Puedes reutilizar el mismo objeto con distintas entradas.
El método sustituye coincidencias no solapadas de izquierda a derecha y devuelve el resultado sin modificar la entrada. Si no hay coincidencias, devuelve la entrada sin cambios. Un count positivo fija el máximo de sustituciones; con 0 o sin el argumento, no hay límite. Se omite una coincidencia vacía si sigue inmediatamente a otra vacía, pero se puede sustituir justo después de una coincidencia no vacía.
Si repl es una cadena, se interpreta como plantilla: \g<id> inserta el texto capturado por el grupo con nombre id y \g<0> inserta la coincidencia completa. Ni siquiera la notación r"..." desactiva el procesamiento de la plantilla. Por ejemplo, \n inserta un salto de línea y una secuencia de escape desconocida formada por una barra invertida y una letra ASCII provoca un error.
Si repl es una función, el método la llama una vez por cada coincidencia que sustituye y le pasa un objeto re.Match. El valor devuelto se inserta literalmente, sin interpretarlo como plantilla. Usa esta opción para insertar cualquier texto de forma literal, en lugar de usar re.escape(), que sirve para preparar patrones. No mezcles str y bytes entre el patrón, la entrada y el valor de sustitución, aunque este último proceda de la función.
Ejemplos
import re
pattern = re.compile(r"sku=(?P<id>[0-9]+)", re.IGNORECASE)
text = "sku=7, SKU=42"
def format_item(match):
return f"item-{int(match.group('id')):04d}"
print(pattern.sub(r"item-\g<id>", text, count=1))
print(pattern.sub(format_item, text))Resultado
item-7, SKU=42 item-0007, item-0042
Las dos llamadas reutilizan el mismo patrón con `re.IGNORECASE`. La plantilla con `count=1` solo cambia `sku=7`. La segunda llamada parte de nuevo del texto original y completa ambos identificadores con ceros hasta cuatro cifras.
Lecciones relacionadas
- Python · Lección 34 · Avanzado · Versión: 5