CKTIS / Python
re.Match.group — obter os grupos correspondentes
O método re.Match.group obtém a correspondência completa ou grupos de captura selecionados pelo respetivo número ou nome.
Versão: Python 3.14; repository image, production runtime not attested
Sintaxe
match.group([group1, ...])re.Match.group é utilizado num objeto de correspondência. Primeiro, confirma que a operação de pesquisa não devolveu None. match.group() e match.group(0) devolvem a correspondência completa, que não é necessariamente todo o texto de entrada.
Os grupos de captura são numerados a partir de 1, pela ordem dos parênteses de abertura. Um grupo (?P<name>...) pode ser selecionado pelo nome ou pelo número. Um argumento seleciona um valor; vários argumentos devolvem um tuplo pela ordem pedida. Os valores correspondentes são do tipo str ou bytes, consoante a entrada.
Um grupo que não participou na correspondência devolve None, enquanto um grupo que corresponde a uma cadeia vazia devolve uma cadeia vazia. No caso de um grupo repetido, só está disponível a última captura. Um número negativo ou fora do intervalo, ou um nome desconhecido, gera IndexError.
Exemplos
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))Resultado
book
book
('book', None)O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.