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

CKTIS / Python

Palavra-chave case

Seleciona um ramo de match testando primeiro o padrão e depois a guarda opcional.

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

Sintaxe

case {"qty": q} if q > 0:
    ...

Seleciona um ramo de match testando primeiro o padrão e depois a guarda opcional.

Os nomes capturados ficam disponíveis na guarda. Uma guarda falsa permite tentar outros casos. Um nome isolado captura, _ é um curinga e o padrão de mapa admite chaves adicionais.

Um padrão irrefutável sem guarda como case _: só é permitido no último ramo.

Exemplos

def label(row):
    match row:
        case {"qty": q} if q > 0:
            return f"positive:{q}"
        case {"qty": 0}:
            return "zero"
        case _:
            return "other"
print([label(row) for row in ({"qty": 2, "tag": "A"}, {"qty": 0}, {})])
try:
    compile("match 1:\n    case _: pass\n    case 1: pass", "<example>", "exec")
except SyntaxError:
    print("unreachable case")

Resultado

['positive:2', 'zero', 'other']
unreachable case

Um padrão irrefutável sem guarda como `case _:` só é permitido no último ramo.

Fontes