`re` — espressioni regolari semplici#

Questo modulo implementa le operazioni con le espressioni regolari. La sintassi delle espressioni regolari supportata è un sottoinsieme del modulo re di CPython (e in realtà è un sottoinsieme delle espressioni regolari estese POSIX).

Gli operatori e le sequenze speciali supportati sono:

.: Corrisponde a un carattere qualsiasi.
[...]: Corrisponde a un insieme di caratteri. Sono supportati sia i singoli caratteri che gli intervalli, inclusi gli insiemi negati (ad esempio [^a-c]).
^: Corrisponde all’inizio della stringa.
$: Corrisponde alla fine della stringa.
?: Corrisponde a zero o una occorrenza del sotto-pattern precedente.
*: Corrisponde a zero o più occorrenze del sotto-pattern precedente.
+: Corrisponde a una o più occorrenze del sotto-pattern precedente.
??: Versione non greedy di ?, corrisponde a zero o una occorrenza, con preferenza per zero.
*?: Versione non greedy di *, corrisponde a zero o più occorrenze, con preferenza per la corrispondenza più breve.
+?: Versione non greedy di +, corrisponde a una o più occorrenze, con preferenza per la corrispondenza più breve.
|: Corrisponde al sotto-pattern alla sinistra oppure al sotto-pattern alla destra di questo operatore.
(...): Raggruppamento. Ogni gruppo è di cattura (la sottostringa che cattura può essere ottenuta con il metodo match.group()).
(?:...): Raggruppamento senza cattura. Ogni gruppo viene confrontato usando le stesse regole del raggruppamento normale, ma non farà parte dell’oggetto match.
\d: Corrisponde a una cifra. Equivalente a [0-9].
\D: Corrisponde a un carattere non numerico. Equivalente a [^0-9].
\s: Corrisponde a uno spazio bianco. Equivalente a [ \t-\r].
\S: Corrisponde a un carattere non di spaziatura. Equivalente a [^ \t-\r].
\w: Corrisponde ai «caratteri di parola» (solo ASCII). Equivalente a [A-Za-z0-9_].
\W: Corrisponde ai caratteri che non sono «caratteri di parola» (solo ASCII). Equivalente a [^A-Za-z0-9_].
\: Carattere di escape. Qualsiasi altro carattere che segue la barra rovesciata, eccetto quelli elencati sopra, viene interpretato letteralmente. Ad esempio, \* è equivalente al * letterale (non viene trattato come l’operatore *). Si noti che \r, \n, ecc. non vengono gestiti in modo speciale e saranno equivalenti alle lettere letterali r, n, ecc. Per questo motivo, non è consigliabile usare le stringhe Python raw (r"") per le espressioni regolari. Ad esempio, r"\r\n" quando usato come espressione regolare è equivalente a "rn". Per far corrispondere il carattere CR seguito da LF, usare "\r\n".

NON SUPPORTATO:

ripetizioni con conteggio ({m,n})
gruppi con nome ((?P<name>...))
asserzioni più avanzate (\b, \B)
escape di caratteri speciali come \r, \n - usare invece l’escaping proprio di Python
ecc.

Esempio:

import re

# As re doesn't support escapes itself, use of r"" strings is not
# recommended.
regex = re.compile("[\r\n]")

regex.split("line1\rline2\nline3\r\n")

# Result:
# ['line1', 'line2', 'line3', '', '']

Funzioni#

re.compile(regex_str: str, flags: int = 0) → 'regex'#: Compila l’espressione regolare e restituisce un oggetto regex.

re.search(regex_str: str, string: str) → 'match | None'#: Compila regex_str e lo cerca in una string. A differenza di match, questo cerca nella stringa la prima posizione che corrisponde all’espressione regolare (che può comunque essere 0 se l’espressione regolare è ancorata).

re.sub(regex_str: str, replace: str | Callable, string: str, count: int = 0, flags: int = 0, /) → str#

Compila regex_str e lo cerca in string, sostituendo tutte le corrispondenze con replace e restituendo la nuova stringa.

replace può essere una stringa o una funzione. Se è una stringa, è possibile usare sequenze di escape della forma \<number> e \g<number> per espandersi nel gruppo corrispondente (o in una stringa vuota per i gruppi senza corrispondenza). Se replace è una funzione, deve accettare un singolo argomento (la corrispondenza) e dovrebbe restituire una stringa di sostituzione.

Se count è specificato e diverso da zero, la sostituzione si interromperà dopo aver effettuato questo numero di sostituzioni. L’argomento flags viene ignorato.

Oggetti Regex#

Espressione regolare compilata. Le istanze di questa classe vengono create usando re.compile().

class re.regex

Oggetto espressione regolare compilata restituito da re.compile().

match(string: str, pos: int = 0, endpos: int | None = None) → 'match | None'#

Applica questa espressione regolare compilata a string, ancorata all’inizio della regione di ricerca, e restituisce un oggetto match, oppure None se l’espressione regolare non corrisponde. Questo è l’equivalente per pattern compilato del match a livello di modulo ed è molto più efficiente quando lo stesso pattern viene applicato a più stringhe.

Il parametro opzionale pos indica un indice in string da cui far iniziare la ricerca; il valore predefinito è 0. Questo non è del tutto equivalente all’estrazione di una porzione della stringa; il carattere di pattern '^' corrisponde all’inizio reale della stringa e nelle posizioni immediatamente successive a un a capo, ma non necessariamente all’indice da cui deve iniziare la ricerca.

Il parametro opzionale endpos limita fino a dove viene cercata string; sarà come se la stringa fosse lunga endpos caratteri, quindi vengono cercati solo i caratteri da pos a endpos - 1. Se endpos è None (il valore predefinito), viene cercata l’intera stringa.

search(string: str, pos: int = 0, endpos: int | None = None) → 'match | None'#

Scorre string cercando la prima posizione in cui questa espressione regolare compilata produce una corrispondenza, e restituisce un oggetto match, oppure None se nessuna posizione corrisponde. Questo è l’equivalente per pattern compilato della funzione search() a livello di modulo ed è molto più efficiente quando lo stesso pattern viene applicato a più stringhe.

sub(replace: str | Callable, string: str, count: int = 0, flags: int = 0, /) → str#

Cerca questa espressione regolare compilata in string, sostituendo tutte le corrispondenze con replace, e restituisce la nuova stringa. Questo è l’equivalente per pattern compilato della funzione sub() a livello di modulo ed è molto più efficiente quando lo stesso pattern viene applicato a più stringhe.

Se count è specificato e diverso da zero, la sostituzione si interromperà dopo aver effettuato questo numero di sostituzioni. L’argomento flags viene ignorato.

split(string: str, max_split: int = -1, /) → List[str]#: Divide una string usando un’espressione regolare. Se viene fornito max_split, esso specifica il numero massimo di divisioni da effettuare. Restituisce un elenco di stringhe (possono esserci fino a max_split+1 elementi se è specificato).

Oggetti Match#

Un oggetto match contiene il risultato di una corrispondenza riuscita.

class re.match(regex_str: str, string: str)#

Confronta regex_str con string, ancorato all’inizio della stringa, e restituisce un oggetto match, oppure None se non corrisponde. Questa è la scorciatoia a livello di modulo: re.match(regex_str, string) è equivalente a re.compile(regex_str).match(string).

Lo stesso oggetto match viene restituito anche da search(), dai metodi per pattern compilato regex.match() / regex.search(), e viene passato alla funzione di sostituzione usata da sub().

group(index: int) → str#: Restituisce la (sotto)stringa corrispondente. index è 0 per l’intera corrispondenza, 1 e oltre per ciascun gruppo di cattura. Sono supportati solo i gruppi numerici.

re — espressioni regolari semplici#

Funzioni#

Oggetti Regex#

Oggetti Match#

`re` — espressioni regolari semplici#