queue --- 一個(gè)同步的隊(duì)列類?

Queue對(duì)象?

隊(duì)列對(duì)象 (Queue, LifoQueue, 或者 PriorityQueue) 提供下列描述的公共方法。

Queue.qsize()?

返回隊(duì)列的大致大小。注意，qsize() > 0 不保證后續(xù)的 get() 不被阻塞，qsize() < maxsize 也不保證 put() 不被阻塞。

Queue.empty()?

如果隊(duì)列為空，返回 True ，否則返回 False 。如果 empty() 返回 True ，不保證后續(xù)調(diào)用的 put() 不被阻塞。類似的，如果 empty() 返回 False ，也不保證后續(xù)調(diào)用的 get() 不被阻塞。

Queue.full()?

如果隊(duì)列是滿的返回 True ，否則返回 False 。如果 full() 返回 True 不保證后續(xù)調(diào)用的 get() 不被阻塞。類似的，如果 full() 返回 False 也不保證后續(xù)調(diào)用的 put() 不被阻塞。

Queue.put(item, block=True, timeout=None)?

將 item 放入隊(duì)列。如果可選參數(shù) block 是 true 并且 timeout 是 None (默認(rèn))，則在必要時(shí)阻塞至有空閑插槽可用。如果 timeout 是個(gè)正數(shù)，將最多阻塞 timeout 秒，如果在這段時(shí)間沒有可用的空閑插槽，將引發(fā) Full 異常。反之 (block 是 false)，如果空閑插槽立即可用，則把 item 放入隊(duì)列，否則引發(fā) Full 異常 ( 在這種情況下，timeout 將被忽略)。

Queue.put_nowait(item)?

Equivalent to put(item, block=False).

Queue.get(block=True, timeout=None)?

從隊(duì)列中移除并返回一個(gè)項(xiàng)目。如果可選參數(shù) block 是 true 并且 timeout 是 None (默認(rèn)值)，則在必要時(shí)阻塞至項(xiàng)目可得到。如果 timeout 是個(gè)正數(shù)，將最多阻塞 timeout 秒，如果在這段時(shí)間內(nèi)項(xiàng)目不能得到，將引發(fā) Empty 異常。反之 (block 是 false) , 如果一個(gè)項(xiàng)目立即可得到，則返回一個(gè)項(xiàng)目，否則引發(fā) Empty 異常 (這種情況下，timeout 將被忽略)。

POSIX系統(tǒng)3.0之前，以及所有版本的Windows系統(tǒng)中，如果 block 是 true 并且 timeout 是 None ， 這個(gè)操作將進(jìn)入基礎(chǔ)鎖的不間斷等待。這意味著，沒有異常能發(fā)生，尤其是 SIGINT 將不會(huì)觸發(fā) KeyboardInterrupt 異常。

Queue.get_nowait()?

相當(dāng)于 get(False) 。

提供了兩個(gè)方法，用于支持跟蹤 排隊(duì)的任務(wù) 是否 被守護(hù)的消費(fèi)者線程 完整的處理。

Queue.task_done()?

表示前面排隊(duì)的任務(wù)已經(jīng)被完成。被隊(duì)列的消費(fèi)者線程使用。每個(gè) get() 被用于獲取一個(gè)任務(wù)， 后續(xù)調(diào)用 task_done() 告訴隊(duì)列，該任務(wù)的處理已經(jīng)完成。

如果 join() 當(dāng)前正在阻塞，在所有條目都被處理后，將解除阻塞(意味著每個(gè) put() 進(jìn)隊(duì)列的條目的 task_done() 都被收到)。

如果被調(diào)用的次數(shù)多于放入隊(duì)列中的項(xiàng)目數(shù)量，將引發(fā) ValueError 異常 。

Queue.join()?

阻塞至隊(duì)列中所有的元素都被接收和處理完畢。

當(dāng)條目添加到隊(duì)列的時(shí)候，未完成任務(wù)的計(jì)數(shù)就會(huì)增加。每當(dāng)消費(fèi)者線程調(diào)用 task_done() 表示這個(gè)條目已經(jīng)被回收，該條目所有工作已經(jīng)完成，未完成計(jì)數(shù)就會(huì)減少。當(dāng)未完成計(jì)數(shù)降到零的時(shí)候， join() 阻塞被解除。

如何等待排隊(duì)的任務(wù)被完成的示例：

import threading, queue

q = queue.Queue()

def worker():
    while True:
        item = q.get()
        print(f'Working on {item}')
        print(f'Finished {item}')
        q.task_done()

# Turn-on the worker thread.
threading.Thread(target=worker, daemon=True).start()

# Send thirty task requests to the worker.
for item in range(30):
    q.put(item)

# Block until all tasks are done.
q.join()
print('All work completed')

SimpleQueue 對(duì)象?

SimpleQueue 對(duì)象提供下列描述的公共方法。

SimpleQueue.qsize()?

返回隊(duì)列的大致大小。注意，qsize() > 0 不保證后續(xù)的 get() 不被阻塞。

SimpleQueue.empty()?

如果隊(duì)列為空，返回 True ，否則返回 False 。如果 empty() 返回 False ，不保證后續(xù)調(diào)用的 get() 不被阻塞。

SimpleQueue.put(item, block=True, timeout=None)?

將 item 放入隊(duì)列。此方法永不阻塞，始終成功（除了潛在的低級(jí)錯(cuò)誤，例如內(nèi)存分配失敗）。可選參數(shù) block 和 timeout 僅僅是為了保持 Queue.put() 的兼容性而提供，其值被忽略。

CPython implementation detail: This method has a C implementation which is reentrant. That is, a put() or get() call can be interrupted by another put() call in the same thread without deadlocking or corrupting internal state inside the queue. This makes it appropriate for use in destructors such as __del__ methods or weakref callbacks.

SimpleQueue.put_nowait(item)?

Equivalent to put(item, block=False), provided for compatibility with Queue.put_nowait().

SimpleQueue.get(block=True, timeout=None)?

從隊(duì)列中移除并返回一個(gè)項(xiàng)目。如果可選參數(shù) block 是 true 并且 timeout 是 None (默認(rèn)值)，則在必要時(shí)阻塞至項(xiàng)目可得到。如果 timeout 是個(gè)正數(shù)，將最多阻塞 timeout 秒，如果在這段時(shí)間內(nèi)項(xiàng)目不能得到，將引發(fā) Empty 異常。反之 (block 是 false) , 如果一個(gè)項(xiàng)目立即可得到，則返回一個(gè)項(xiàng)目，否則引發(fā) Empty 異常 (這種情況下，timeout 將被忽略)。

SimpleQueue.get_nowait()?

相當(dāng)于 get(False) 。