Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

re.Pattern.search: trovare la prima corrispondenza con un pattern compilato

Usa un’espressione regolare compilata per trovare la prima corrispondenza in una stringa o in un intervallo delimitato da indici.

Versione: Python 3.12

Sintassi

pattern = re.compile(expression, flags=0)
pattern.search(string[, pos[, endpos]]) -> re.Match | None

re.Pattern.search è un metodo dell’oggetto restituito da re.compile(). La chiamata pattern.search(string) restituisce un oggetto re.Match per la prima posizione in cui il pattern trova una corrispondenza, anche nel mezzo della stringa. Invece, pattern.match() prova solo nella posizione iniziale e pattern.fullmatch() richiede che corrisponda l’intero intervallo specificato.

L’indice facoltativo pos indica dove inizia la ricerca e vale 0 per impostazione predefinita. endpos è il limite superiore escluso e, se omesso, equivale alla lunghezza della stringa. In CPython 3.12, i valori di pos e endpos vengono ricondotti all’intervallo da 0 alla lunghezza della stringa, estremi inclusi. Se dopo questo aggiustamento endpos < pos, il metodo restituisce None. Impostare pos non equivale a estrarre una porzione della stringa: l’ancora ^ non considera pos un nuovo inizio della stringa.

Controlla match is not None prima di leggere il risultato. Una corrispondenza di lunghezza zero è comunque un oggetto re.Match. match.group(0) restituisce l’intera sottostringa corrispondente e match.span() ne restituisce gli indici (inizio, fine) nella stringa originale, con l’indice finale escluso.

La funzione del modulo re.search(pattern, string, flags=0) riceve il pattern come argomento e non ha parametri pos o endpos. Il metodo usa il pattern già memorizzato nell’oggetto compilato, che puoi riutilizzare. Passa i flag come argomenti a re.compile(), non a pattern.search().

Esempi

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

Risultato

A17 (5, 8)
B42 (10, 13)
None

Il pattern riconosce una lettera maiuscola ASCII seguita da due cifre ASCII. La prima chiamata trova `A17`; partendo da `pos=8` lo salta e trova `B42`. Con `endpos=12`, il `2` finale è fuori dall’intervallo di ricerca, quindi il risultato è `None`.

Lezioni correlate

  • Python · Lezione 30 · Intermedio · Versione: 3

Fonti