4.2.4 Oggetti Espressioni Regolari

Gli oggetti compilati come espressioni regolari supportano i seguenti metodi e attributi:

match( string[, pos[, endpos]])

Se zero o più caratteri all'inizio di string corrispondono al modello dell'espressione regolare, restituisce una corrispondente istanza MatchObject. Restituisce None se la stringa non corrisponde al modello; notate che questo è differente rispetto ad una corrispondenza a lunghezza zero.

Note: Se volete localizzare una corrispondenza ovunque nella string, utilizzate search()

Il secondo argomento facoltativo pos fornisce un indice nella stringa per indicare dove deve iniziare la ricerca; il valore predefinito è 0. Questo non è completamente equivalente ad affettare la stringa (NdT: "to slicing" nel testo originale); il carattere '^' nel modello corrisponde al reale inizio della stringa e alla posizione immediatamente successiva ad un fine riga, ma non necessariamente all'indice dove la ricerca inizia.

Il parametro facoltativo endpos limita la distanza massima in cui verrà effettuata la corrispondenza sulla stringa; si comporta come se la stringa avesse lunghezza pari a endpos, così solo i caratteri da pos ad endpos - 1 verranno ricercati per una corrispondenza. Se endpos è minore di pos, nessuna corrispondenza verrà effettuata, altrimenti, se rx è compilata in un oggetto corrispondente ad un'espressione regolare, rx.match(string, 0, 50) è equivalente a rx.match(string[:50], 0).

search( string[, pos[, endpos]]): Analizza la string cercando una posizione in cui il modello dell'espressione regolare generi una corrispondenza, e restituisce una corrispondente istanza MatchObject. Restituisce None se nessuna posizione della stringa corrisponde al modello; notate che questo è diverso dal trovare una corrispondenza di lunghezza zero in qualche punto della stringa.
I parametri facoltativi pos ed endpos hanno lo stesso significato indicato per il metodo match().

split( string[, maxsplit = 0]): Identica alla funzione split(), utilizzando il modello compilato.

findall( string): Identica alla funzione findall(), utilizzando il modello compilato.

finditer( string): Identica alla funzione finditer(), utilizzando il modello compilato.

sub( repl, string[, count = 0]): Identica alla funzione sub(), utilizzando il modello compilato.

subn( repl, string[, count = 0]): Identica alla funzione subn(), utilizzando il modello compilato.

flags: L'argomento flags (NdT: opzioni) utilizzato quando l'oggetto corrispondente all'espressione è stato compilato, o 0 se nessuna opzione è stata impostata.

groupindex: Un dizionario che associa tutti i nomi dei gruppi simbolici definiti da (?P<id>) ai numeri identificativi dei gruppi. Il dizionario è vuoto se nel modello non vengono utilizzati gruppi simbolici.

pattern: La stringa corrispondente al modello da cui l'oggetto espressione regolare è stato compilato.

Vedete Circa questo documento... per informazioni su modifiche e suggerimenti.