Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes