python中queue使用_python --- queue模块使用

1 Queue.empty()2 """

3 如果队列为空，返回True，否则返回False。如果empty()返回True，它不保证后续调用put()不会阻塞。类似的，如果empty()返回False也不能保证接下来的get()调用不会被阻塞。4 """

5

6 Queue.full()7 """

8 如果队列已满，则返回True，否则返回False。如果full()返回True，它不保证后续调用get()不会阻塞。类似的，如果full()返回False并不能保证接下来的put()调用不会被阻塞。9 """

10

11 Queue.qsize()12 """

13 返回队列的近似大小。注意，qsize()> 0不保证随后的get()不会阻塞，qsize() < maxsize也不会保证put()不会被阻塞。14 """

15

16 Queue.put(item, block=True, timeout=None)17 """

18 将item放入队列中。如果可选的参数block为True且timeout为None(默认的情况，阻塞调用，无超时)，如有必要(比如队列满)，阻塞调用线程，直到有空闲槽可用。如果超时是正数，则它最多阻塞超时秒，如果在该时间内没有空闲插槽，则引发Full异常。如果block为False，如果有空闲槽可用将数据放入队列，否则立即抛出Full异常(非阻塞调用，timeout被忽略)。19 """

20

21 Queue.get(block=True, timeout=None)22 """

23 从队列中移除并返回一个数据。如果可选的参数block为True且timeout为None(默认的情况，阻塞调用，无超时)，阻塞调用进程直到有数据可用。如果超时是正数，则它最多阻塞超时秒，如果在该时间内没有可用的项，则引发Empty异常。如果block为False，如果有数据可用返回数据，否则立即抛出Empty异常(非阻塞调用，timeout被忽略)。24 """

25

26 Queue.put_nowait(item)27 """

28 等同于put(item, block=False)(非阻塞调用)。29 """

30

31 Queue.get_nowait()32 """

33 等同于get(block=False)(非阻塞调用)。34 """

35

36 Queue.task_done()37 """

38 意味着之前入队的一个任务已经完成。由队列的消费者线程调用。每一个get()调用得到一个任务，接下来的task_done()调用告诉队列该任务已经处理完毕。39

40 If a join() is currently blocking, it will resume when all items have been processed (meaning that a task_done() call was received for every item that had been put() into the queue).41

42 如果该方法被调用的次数多于被放入队列中的任务的个数，ValueError异常会被抛出。43 """

44

45 Queue.join()46 """

47 阻塞调用线程，直到队列中的所有任务被处理掉。48

49 只要有数据被加入队列，未完成的任务数就会增加。当消费者线程调用task_done()以指示该项目已检索并且其上的所有工作都已完成时，计数将减少。当未完成的任务数降到0，join()解除阻塞。50 """