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

CKTIS / Python

Palavra-chave match

Avalia o sujeito uma vez e testa os padrões case por ordem.

Versão: Python 3.14; repository image, production runtime not attested

Sintaxe

match subject:
    case pattern:
        ...

Avalia o sujeito uma vez e testa os padrões case por ordem.

O primeiro padrão compatível com guarda verdadeira ou ausente escolhe o bloco. Não se passa automaticamente ao seguinte.

Sem correspondência nem curinga a instrução termina sem erro. match e case podem ser identificadores noutros contextos.

Exemplos

def sample(value):
    calls = []
    def subject():
        calls.append("once")
        return value
    match subject():
        case [x, y]:
            calls.append(x + y)
        case {"total": amount}:
            calls.append(amount)
    return calls
print(sample([2, 3]), sample({"total": 7}), sample("ab"))

Resultado

['once', 5] ['once', 7] ['once']

Sem correspondência nem curinga a instrução termina sem erro. match e case podem ser identificadores noutros contextos.

Fontes