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

CKTIS / Python

re.Pattern.fullmatch: comprobar la cadena completa

Este método de una expresión regular compilada comprueba si el patrón coincide con toda la cadena o con todo el intervalo delimitado por `pos` y `endpos`.

Versión: Python 3.12

Sintaxis

compiled.fullmatch(string[, pos[, endpos]]) -> re.Match | None

re.Pattern.fullmatch es un método del objeto que devuelve re.compile(). Si no se indican límites, el patrón debe abarcar toda la cadena. El método devuelve un objeto re.Match si hay coincidencia y None si no la hay. Una coincidencia de longitud cero también cuenta; usa result is not None para comprobar si hubo coincidencia.

El índice opcional pos marca el inicio (0 por defecto), y endpos marca el final, excluido del intervalo (len(string) por defecto). La coincidencia debe abarcar todo ese intervalo. En CPython 3.12, ambos índices se ajustan al intervalo de 0 a len(string), ambos inclusive. Si después del ajuste endpos es menor que pos, no hay coincidencia. Si los valores resultantes son iguales, puede haber una coincidencia de longitud cero. span() devuelve índices de la cadena original. Fijar límites no equivale a extraer una subcadena: por ejemplo, ^ no trata pos como un nuevo inicio de la cadena.

Usa Pattern.match() si basta con una coincidencia al principio del intervalo, o Pattern.search() para encontrarla en cualquier punto del intervalo. La función del módulo re.fullmatch(pattern, string, flags=0) recibe el patrón como argumento, pero no ofrece pos ni endpos. El método usa el patrón ya compilado y sus opciones; no admite el argumento flags.

Ejemplos

import re

code_pattern = re.compile(r"[A-Z]{2}-[0-9]{2}")

print(code_pattern.fullmatch("AB-42") is not None)
print(code_pattern.fullmatch("AB-42!") is not None)

match = code_pattern.fullmatch("[AB-42]", 1, 6)
assert match is not None
print(match.span())

Resultado

True
False
(1, 6)

El patrón exige dos letras mayúsculas ASCII, un guion y dos dígitos ASCII. `AB-42` coincide, pero `AB-42!` no. En `[AB-42]`, el intervalo de `1` inclusive a `6` exclusive deja fuera ambos corchetes, por lo que `span()` devuelve `(1, 6)`.

Lecciones relacionadas

  • Python · Lección 29 · Intermedio · Versión: 3

Fuentes