Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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 | None

re.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

Fuentes