Document asyncio.QueueFull/Empty.

This commit is contained in:
Guido van Rossum 2014-01-25 17:38:31 -08:00
parent d6fb2c7629
commit 9ad116bcd0
1 changed files with 18 additions and 2 deletions

View File

@ -286,7 +286,7 @@ Queue
Remove and return an item from the queue. Remove and return an item from the queue.
Return an item if one is immediately available, else raise Return an item if one is immediately available, else raise
:exc:`~queue.Empty`. :exc:`QueueEmpty`.
.. method:: put(item) .. method:: put(item)
@ -301,7 +301,7 @@ Queue
Put an item into the queue without blocking. Put an item into the queue without blocking.
If no free slot is immediately available, raise :exc:`~queue.Full`. If no free slot is immediately available, raise :exc:`QueueFull`.
.. method:: qsize() .. method:: qsize()
@ -367,3 +367,19 @@ JoinableQueue
Raises :exc:`ValueError` if called more times than there were items Raises :exc:`ValueError` if called more times than there were items
placed in the queue. placed in the queue.
Exceptions
^^^^^^^^^^
.. exception:: QueueEmpty
Exception raised when non-blocking :meth:`~Queue.get` (or
:meth:`~Queue.get_nowait`) is called
on a :class:`Queue` object which is empty.
.. exception:: QueueFull
Exception raised when non-blocking :meth:`~Queue.put` (or
:meth:`~Queue.put_nowait`) is called
on a :class:`Queue` object which is full.