From 47aa9897d9c2152bc13161ee115147519d099205 Mon Sep 17 00:00:00 2001 From: Raymond Hettinger Date: Sat, 7 Mar 2009 14:07:37 +0000 Subject: Redocument the empty() and full() methods. --- Doc/library/queue.rst | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/Doc/library/queue.rst b/Doc/library/queue.rst index 4ed3dcc..acd953d 100644 --- a/Doc/library/queue.rst +++ b/Doc/library/queue.rst @@ -78,6 +78,22 @@ provide the public methods described below. guarantee that put() will not block. +.. method:: Queue.empty() + + Return ``True`` if the queue is empty, ``False`` otherwise. If empty() + returns ``True`` it doesn't guarantee that a subsequent call to put() + will not block. Similarly, if empty() returns ``False`` it doesn't + guarantee that a subsequent call to get() will not block. + + +.. method:: Queue.full() + + Return ``True`` if the queue is full, ``False`` otherwise. If full() + returns ``True`` it doesn't guarantee that a subsequent call to get() + will not block. Similarly, if full() returns ``False`` it doesn't + guarantee that a subsequent call to put() will not block. + + .. method:: Queue.put(item[, block[, timeout]]) Put *item* into the queue. If optional args *block* is true and *timeout* is -- cgit v0.12