WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

asyncio.gather

Startet Koroutinen nebenläufig und liefert nach await eine Liste in Argumentreihenfolge.

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

Syntax

asyncio.gather(*aws, return_exceptions=False)

Startet Koroutinen nebenläufig und liefert nach await eine Liste in Argumentreihenfolge.

Standardmäßig wird die erste Ausnahme weitergegeben und die übrigen Tasks laufen weiter. Abbruch eines noch laufenden gather bricht offene Kinder ab.

Bei return_exceptions=True belegt die Ausnahme ihren eigenen Platz, daher erscheinen 5 und ValueError.

import asyncio
async def main():
    gate = asyncio.Event()
    slow = asyncio.create_task(gate.wait())
    async def fail():
        raise ValueError("bad")
    try:
        await asyncio.gather(slow, fail())
    except ValueError:
        assert not slow.done()
    gate.set()
    assert await slow is True
asyncio.run(main())

Beispiele

import asyncio
async def fail():
    raise ValueError("sample")

async def main():
    results = await asyncio.gather(asyncio.sleep(0, result=5), fail(), return_exceptions=True)
    print(results[0], type(results[1]).__name__)

asyncio.run(main())

Ergebnis

5 ValueError

Bei return_exceptions=True belegt die Ausnahme ihren eigenen Platz, daher erscheinen 5 und ValueError.

Quellen