clarify recv* are blocking operations; thanks to Chris Kogelnik from docs@

This commit is contained in:
Sandro Tosi 2012-01-07 17:56:43 +01:00
parent 36cdca1277
commit f788cf70f8
1 changed files with 6 additions and 3 deletions

View File

@ -727,7 +727,8 @@ Connection objects are usually created using :func:`Pipe` -- see also
.. method:: recv()
Return an object sent from the other end of the connection using
:meth:`send`. Raises :exc:`EOFError` if there is nothing left to receive
:meth:`send`. Blocks until there its something to receive. Raises
:exc:`EOFError` if there is nothing left to receive
and the other end was closed.
.. method:: fileno()
@ -761,7 +762,8 @@ Connection objects are usually created using :func:`Pipe` -- see also
.. method:: recv_bytes([maxlength])
Return a complete message of byte data sent from the other end of the
connection as a string. Raises :exc:`EOFError` if there is nothing left
connection as a string. Blocks until there is something to receive.
Raises :exc:`EOFError` if there is nothing left
to receive and the other end has closed.
If *maxlength* is specified and the message is longer than *maxlength*
@ -771,7 +773,8 @@ Connection objects are usually created using :func:`Pipe` -- see also
.. method:: recv_bytes_into(buffer[, offset])
Read into *buffer* a complete message of byte data sent from the other end
of the connection and return the number of bytes in the message. Raises
of the connection and return the number of bytes in the message. Blocks
until there is something to receive. Raises
:exc:`EOFError` if there is nothing left to receive and the other end was
closed.