WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

asyncio.Future

Verbindet rückrufbasierte Fertigstellung über ein von der Schleife erzeugtes Objekt mit await.

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

Syntax

future = asyncio.get_running_loop().create_future()

Verbindet rückrufbasierte Fertigstellung über ein von der Schleife erzeugtes Objekt mit await.

Ein Future speichert ein Ergebnis, eine Ausnahme oder einen Abbruch und mehrmaliges await sieht denselben Ausgang. result() vor Abschluss und erneutes set_result danach lösen InvalidStateError aus.

Im Beispiel wird 7 geliefert und das zweite Setzen auf 9 abgewiesen.

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

Beispiele

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

Ergebnis

True False
7
InvalidStateError

Im Beispiel wird 7 geliefert und das zweite Setzen auf 9 abgewiesen.

Quellen