CKTIS / Python
re.Pattern.fullmatch: verificare l’intera stringa
Questo metodo di un’espressione regolare compilata controlla se il pattern corrisponde all’intera stringa o all’intero intervallo delimitato da `pos` ed `endpos`.
Versione: Python 3.12
Sintassi
compiled.fullmatch(string[, pos[, endpos]]) -> re.Match | Nonere.Pattern.fullmatch è un metodo dell’oggetto restituito da re.compile(). Senza limiti espliciti, il pattern deve coprire l’intera stringa. Il metodo restituisce un oggetto re.Match se trova una corrispondenza e None altrimenti. Anche una corrispondenza di lunghezza zero è valida; usa result is not None per verificare che il metodo abbia trovato una corrispondenza.
L’indice facoltativo pos indica l’inizio (valore predefinito: 0), mentre endpos indica la fine, esclusa dall’intervallo (valore predefinito: len(string)). La corrispondenza deve coprire tutto l’intervallo. In CPython 3.12 entrambi gli indici vengono ricondotti all’intervallo da 0 a len(string), estremi inclusi. Se dopo questo adeguamento endpos è minore di pos, non c’è corrispondenza. Se i valori risultanti sono uguali, è possibile una corrispondenza di lunghezza zero. span() restituisce gli indici nella stringa originale. Impostare i limiti non equivale a estrarre una sottostringa: per esempio, ^ non considera pos un nuovo inizio della stringa.
Usa Pattern.match() se basta una corrispondenza all’inizio dell’intervallo, oppure Pattern.search() per trovarne una in qualsiasi punto dell’intervallo. La funzione del modulo re.fullmatch(pattern, string, flags=0) riceve il pattern come argomento, ma non offre pos né endpos. Il metodo usa il pattern già compilato e i relativi flag; non accetta un argomento flags.
Esempi
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())Risultato
True False (1, 6)
Il pattern richiede due lettere maiuscole ASCII, un trattino e due cifre ASCII. `AB-42` corrisponde al pattern, mentre `AB-42!` no. In `[AB-42]`, l’intervallo da `1` incluso a `6` escluso lascia fuori entrambe le parentesi quadre, quindi `span()` restituisce `(1, 6)`.
Lezioni correlate
- Python · Lezione 29 · Intermedio · Versione: 3