Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

re.Match.group — recuperare i gruppi corrispondenti

Il metodo re.Match.group recupera l’intera corrispondenza oppure i gruppi di cattura selezionati tramite numero o nome.

Versione: Python 3.14; repository image, production runtime not attested

Sintassi

match.group([group1, ...])

re.Match.group si usa su un oggetto di corrispondenza. Per prima cosa, verifica che l’operazione di ricerca non abbia restituito None. match.group() e match.group(0) restituiscono l’intera corrispondenza, che non è necessariamente tutto il testo di input.

I gruppi di cattura sono numerati a partire da 1, nell’ordine delle parentesi di apertura. Un gruppo (?P<name>...) può essere selezionato tramite nome o numero. Un argomento seleziona un valore; più argomenti restituiscono una tupla nell’ordine richiesto. A seconda dell’input, i valori corrispondenti sono di tipo str o bytes.

Un gruppo che non ha partecipato alla corrispondenza restituisce None, mentre un gruppo che corrisponde a una stringa vuota restituisce una stringa vuota. Per un gruppo ripetuto è disponibile solo l’ultima cattura. Un numero negativo o fuori intervallo, oppure un nome sconosciuto, genera IndexError.

Esempi

import re

match = re.fullmatch(r"(?P<item>[a-z]+)(?:-([0-9]+))?", "book")
if match is None:
    raise ValueError("No match")

print(match.group())
print(match.group("item"))
print(match.group(1, 2))

Risultato

book
book
('book', None)

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti