CKTIS / Python
asyncio.Queue
Passa elementi tra task in ordine FIFO.
Versione: Python 3.14; repository image, production runtime not attested
Sintassi
asyncio.Queue(maxsize=0)Passa elementi tra task in ordine FIFO.
join attende il contatore dei lavori incompleti e un task_done in eccesso solleva ValueError. shutdown(immediate=True) può scartare elementi non elaborati. asyncio.wait_for applica un limite di tempo. La coda non è sicura tra thread. Con maxsize<=0 la capacità è illimitata. put attende spazio e get dati, le varianti immediate sollevano QueueFull o QueueEmpty. Nell’esempio 9 non entra, get restituisce 8 e task_done permette a join di terminare.
Dalla 3.13 shutdown normale impedisce nuovi inserimenti e consente di svuotare la coda.
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())
Esempi
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())
Risultato
True 8
Dalla 3.13 shutdown normale impedisce nuovi inserimenti e consente di svuotare la coda.