Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Python

asyncio.gather

Uruchamia współbieżnie korutyny i po await dostarcza listę w kolejności argumentów.

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

Składnia

asyncio.gather(*aws, return_exceptions=False)

Uruchamia współbieżnie korutyny i po await dostarcza listę w kolejności argumentów.

Domyślnie pierwszy wyjątek przechodzi do wywołującego, a pozostałe zadania pracują dalej. Anulowanie oczekującego gather anuluje niedokończone dzieci.

Przy return_exceptions=True wyjątek zajmuje własną pozycję, dlatego przykład wypisuje 5 i 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())

Przykłady

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

Wynik

5 ValueError

Przy return_exceptions=True wyjątek zajmuje własną pozycję, dlatego przykład wypisuje 5 i ValueError.

Źródła