Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Python

asyncio.Queue

Odovzdáva prvky medzi úlohami v poradí FIFO.

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

Syntax

asyncio.Queue(maxsize=0)

Odovzdáva prvky medzi úlohami v poradí FIFO.

join čaká na počítadlo nedokončenej práce a nadbytočné task_done vyvolá ValueError. shutdown(immediate=True) môže zahodiť nespracované prvky. Časový limit nastaví asyncio.wait_for. Rad nie je bezpečný medzi vláknami. Pri maxsize<=0 je kapacita neobmedzená. put čaká na miesto a get na údaje, okamžité varianty vyvolajú QueueFull alebo QueueEmpty. V príklade sa 9 nezmestí, get vráti 8 a task_done umožní dokončiť join.

Od 3.13 bežné shutdown zakáže ďalšie vkladanie a dovolí rad vyprázdniť.

import asyncio
async def main():
    q = asyncio.Queue(maxsize=1)
    await q.put(7)
    try:
        q.put_nowait(8)
    except asyncio.QueueFull:
        pass
    q.shutdown()
    assert await q.get() == 7
    q.task_done()
    await q.join()
    try:
        await q.get()
    except asyncio.QueueShutDown:
        pass
    else:
        raise AssertionError
asyncio.run(main())
import asyncio
async def main():
    q = asyncio.Queue()
    await q.put(1)
    q.shutdown(immediate=True)
    await asyncio.wait_for(q.join(), 1)
    assert q.empty()
    try:
        q.task_done()
    except ValueError:
        pass
    else:
        raise AssertionError
asyncio.run(main())

Príklady

import asyncio

async def main():
    queue = asyncio.Queue(maxsize=1)
    await queue.put(8)
    try:
        queue.put_nowait(9)
    except asyncio.QueueFull:
        print(queue.full())
    print(await queue.get())
    queue.task_done()
    await queue.join()

asyncio.run(main())

Výsledok

True
8

Od 3.13 bežné shutdown zakáže ďalšie vkladanie a dovolí rad vyprázdniť.

Zdroje