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

CKTIS / Python

Palavra-chave with

Entra no contexto e associa opcionalmente o resultado de `__enter__` ao destino de as.

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

Sintaxe

with manager as value:
    ...

Entra no contexto e associa opcionalmente o resultado de __enter__ ao destino de as.

Após uma entrada bem-sucedida, __exit__ é chamado ao sair do bloco, mesmo por exceção. Um resultado verdadeiro de __exit__ suprime essa exceção e um falso permite a sua propagação. Se o próprio __enter__ falhar, o Python não chama __exit__ desse gestor. Com vários gestores entra-se da esquerda para a direita e sai-se pela ordem inversa.

Se uma entrada posterior falhar, o último gestor aberto recebe a exceção e pode suprimi-la.

Exemplos

class Gate:
    def __enter__(self):
        return "inside"
    def __exit__(self, typ, val, tb):
        print(typ.__name__ if typ else "normal")
        return typ is ValueError
with Gate() as label:
    print(label)
    raise ValueError("handled")
print("continued")
from contextlib import contextmanager
trace = []
@contextmanager
def record(name, fail=False):
    trace.append("enter " + name)
    if fail:
        raise KeyError(name)
    try:
        yield
    finally:
        trace.append("exit " + name)
try:
    with record("A"), record("B"), record("C", True):
        raise AssertionError("body")
except KeyError:
    pass
assert trace == ["enter A", "enter B", "enter C", "exit B", "exit A"]

Resultado

inside
ValueError
continued

Se uma entrada posterior falhar, o último gestor aberto recebe a exceção e pode suprimi-la.

Fontes