Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Python

asyncio.Future

Relie une terminaison par rappel à await grâce à un objet créé par la boucle.

Version : Python 3.14; repository image, production runtime not attested

Syntaxe

future = asyncio.get_running_loop().create_future()

Relie une terminaison par rappel à await grâce à un objet créé par la boucle.

Un Future conserve un résultat, une exception ou une annulation, identique pour chaque await. result() avant achèvement et un second set_result après achèvement lèvent InvalidStateError.

L’exemple récupère 7 et rejette la tentative de fixer 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())

Exemples

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())

Résultat

True False
7
InvalidStateError

L’exemple récupère 7 et rejette la tentative de fixer 9.

Sources