CKTIS / Python
re.Pattern.search: encontrar la primera coincidencia con un patrón compilado
Usa una expresión regular compilada para encontrar la primera coincidencia en una cadena o en un intervalo delimitado por índices.
Versión: Python 3.12
Sintaxis
pattern = re.compile(expression, flags=0)
pattern.search(string[, pos[, endpos]]) -> re.Match | Nonere.Pattern.search es un método del objeto que devuelve re.compile(). La llamada pattern.search(string) devuelve un objeto re.Match para la primera posición donde encaja el patrón, incluso en mitad de la cadena. En cambio, pattern.match() solo lo intenta en la posición inicial y pattern.fullmatch() exige que coincida todo el intervalo indicado.
El índice opcional pos indica dónde empieza la búsqueda y vale 0 por defecto. endpos es el límite superior excluido y, por defecto, equivale a la longitud de la cadena. En CPython 3.12, los valores de pos y endpos se ajustan al intervalo entre 0 y la longitud de la cadena, ambos incluidos. Si endpos < pos después de ese ajuste, el método devuelve None. Indicar pos no equivale a recortar la cadena: el ancla ^ no trata pos como un nuevo inicio de cadena.
Comprueba match is not None antes de leer el resultado. Una coincidencia de longitud cero sigue siendo un objeto re.Match. match.group(0) devuelve toda la subcadena coincidente y match.span() devuelve sus índices (inicio, fin) en la cadena original, con el índice final excluido.
La función del módulo re.search(pattern, string, flags=0) recibe el patrón como argumento y no tiene parámetros pos ni endpos. El método usa el patrón que ya está en el objeto compilado, que puedes reutilizar. Pasa las opciones como argumentos a re.compile(), no a pattern.search().
Ejemplos
import re
pattern = re.compile(r"[A-Z][0-9]{2}")
text = "IDs: A17, B42"
for match in (pattern.search(text), pattern.search(text, pos=8)):
if match is not None:
print(match.group(0), match.span())
print(pattern.search(text, pos=8, endpos=12))Resultado
A17 (5, 8) B42 (10, 13) None
El patrón reconoce una letra ASCII mayúscula seguida de dos dígitos ASCII. La primera llamada encuentra `A17`; al empezar en `pos=8`, lo omite y encuentra `B42`. Con `endpos=12`, el último `2` queda fuera del intervalo de búsqueda, así que el resultado es `None`.
Lecciones relacionadas
- Python · Lección 30 · Intermedio · Versión: 3