[Python-checkins] CVS: python/dist/src/Doc/lib libsocket.tex,1.51.4.2,1.51.4.3

2002年1月10日 02:04:07 -0800

Update of /cvsroot/python/python/dist/src/Doc/lib
In directory usw-pr-cvs1:/tmp/cvs-serv10790
Modified Files:
 Tag: release21-maint
	libsocket.tex 
Log Message:
backport Fred's 1.58:
Added documentation of the sendall() method, and a note to the send() method
that it does not guarantee that all data is sent.
Index: libsocket.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libsocket.tex,v
retrieving revision 1.51.4.2
retrieving revision 1.51.4.3
diff -C2 -d -r1.51.4.2 -r1.51.4.3
*** libsocket.tex	2001年12月22日 19:09:42	1.51.4.2
--- libsocket.tex	2002年01月10日 10:04:04	1.51.4.3
***************
*** 371,374 ****
--- 371,387 ----
 socket. The optional \var{flags} argument has the same meaning as for
 \method{recv()} above. Returns the number of bytes sent.
+ Applications are responsible for checking that all data has been sent;
+ if only some of the data was transmitted, the application needs to
+ attempt delivery of the remaining data.
+ \end{methoddesc}
+ 
+ \begin{methoddesc}[socket]{sendall}{string\optional{, flags}}
+ Send data to the socket. The socket must be connected to a remote
+ socket. The optional \var{flags} argument has the same meaning as for
+ \method{recv()} above. Unlike \method{send()}, this method continues
+ to send data from \var{string} until either all data has been sent or
+ an error occurs. \code{None} is returned on success. On error, an
+ exception is raised, and there is no way to determine how much data,
+ if any, was successfully sent.
 \end{methoddesc}