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

CKTIS / Python

asyncio.gather

Lance les coroutines en concurrence et fournit après await une liste dans l’ordre des arguments.

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

Syntaxe

asyncio.gather(*aws, return_exceptions=False)

Lance les coroutines en concurrence et fournit après await une liste dans l’ordre des arguments.

Par défaut la première exception se propage et les autres tâches continuent. Annuler un gather en attente annule les enfants inachevés.

Avec return_exceptions=True l’exception occupe sa position, d’où 5 puis 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())

Exemples

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

Résultat

5 ValueError

Avec return_exceptions=True l’exception occupe sa position, d’où 5 puis ValueError.

Sources