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

CKTIS / Python

ExitStack.close(): libertação explícita por ordem LIFO

Regista gestores de contexto durante a execução e chama `stack.close()` para libertar os recursos pela ordem inversa à do registo, antes de terminar o bloco `with`.

Versão: Python 3.12

Sintaxe

from contextlib import ExitStack

with ExitStack() as stack:
    for cm in managers:
        value = stack.enter_context(cm)
        # Use value while its context is active.
    stack.close()

Quando o número de gestores de contexto depende dos dados de entrada, chama stack.enter_context(cm) dentro de with ExitStack() as stack:. O método chama cm.__enter__(), devolve o seu resultado e regista cm.__exit__() se a entrada for bem-sucedida. Se a entrada num contexto posterior falhar, o bloco with garante que as funções de saída dos contextos já registados são chamadas.

contextlib.ExitStack.close é um método síncrono que se chama sem argumentos: stack.close(). Retira da pilha e executa de imediato as funções registadas pela ordem inversa à do registo (LIFO). Não sai do bloco with: se a chamada terminar normalmente, a execução prossegue. Ao sair do bloco, as funções já retiradas não voltam a ser executadas. Não uses recursos que já tenham sido libertados.

Uma chamada explícita a close() inicia a libertação como se não tivesse ocorrido nenhuma exceção. Em contrapartida, se uma exceção sair do corpo do bloco with, a saída automática passa os seus detalhes às funções de saída ainda na pilha. Se uma função lançar ou suprimir uma exceção durante a libertação, as funções de saída seguintes recebem o estado atualizado. Uma exceção que não seja suprimida durante a libertação pode propagar-se para fora de close().

Chama close() quando for preciso libertar os recursos antes de terminar o bloco. Caso contrário, deixa with tratar disso automaticamente. A recolha de lixo não executa as funções registadas.

Exemplos

from contextlib import ExitStack, contextmanager


@contextmanager
def traced(name):
    print(f"enter {name}")
    try:
        yield name
    finally:
        print(f"exit {name}")


names = ["A", "B", "C"]
with ExitStack() as stack:
    active = [stack.enter_context(traced(name)) for name in names]
    print("use:", ", ".join(active))
    stack.close()
    print("still inside")
print("outside")

Resultado

enter A
enter B
enter C
use: A, B, C
exit C
exit B
exit A
still inside
outside

`names` determina os contextos registados dentro de `with`. No resultado esperado, as linhas `exit` aparecem pela ordem C, B, A antes de `still inside`. Não voltam a ser apresentadas quando se sai do bloco.

Lições relacionadas

  • Python · Lição 12 · Avançado · Versão: 5

Fontes