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.