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

CKTIS / Python

asyncio.Future

Liga a conclusão por função de retorno a await através de um objeto criado pelo ciclo.

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

Sintaxe

future = asyncio.get_running_loop().create_future()

Liga a conclusão por função de retorno a await através de um objeto criado pelo ciclo.

Um Future guarda um resultado, exceção ou cancelamento e vários await observam o mesmo desfecho. result() antes da conclusão e novo set_result depois geram InvalidStateError.

O exemplo obtém 7 e rejeita a segunda tentativa de definir 9.

import asyncio
async def main():
    f = asyncio.get_running_loop().create_future()
    try:
        f.result()
    except asyncio.InvalidStateError:
        pass
    else:
        raise AssertionError
    f.set_result(5)
    assert await f == 5 and await f == 5
    g = asyncio.get_running_loop().create_future()
    g.cancel()
    assert g.done() and g.cancelled()
asyncio.run(main())

Exemplos

import asyncio

async def main():
    future = asyncio.get_running_loop().create_future()
    print(isinstance(future, asyncio.Future), future.done())
    future.set_result(7)
    print(await future)
    try:
        future.set_result(9)
    except asyncio.InvalidStateError as error:
        print(type(error).__name__)

asyncio.run(main())

Resultado

True False
7
InvalidStateError

O exemplo obtém 7 e rejeita a segunda tentativa de definir 9.

Fontes