X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/07b732709364e538ab7ccc49d8f2643d9d28b49d..f53561f1f0860024afcc44cdf581e57080d457bf:/docs/latex/wx/socket.tex?ds=sidebyside diff --git a/docs/latex/wx/socket.tex b/docs/latex/wx/socket.tex index 122bf38f64..49a59bb227 100644 --- a/docs/latex/wx/socket.tex +++ b/docs/latex/wx/socket.tex @@ -4,6 +4,10 @@ \helpref{wxEvtHandler}{wxevthandler} +\wxheading{Include files} + + + % --------------------------------------------------------------------------- % Event handling % --------------------------------------------------------------------------- @@ -23,7 +27,9 @@ functions that take a \helpref{wxSocketEvent}{wxsocketevent} argument. % --------------------------------------------------------------------------- \wxheading{See also} -\helpref{wxSocketEvent}{wxsocketevent}, \helpref{wxSocketClient}{wxsocketclient}, \helpref{wxSocketServer}{wxsocketserver} +\helpref{wxSocketEvent}{wxsocketevent}\\ +\helpref{wxSocketClient}{wxsocketclient}\\ +\helpref{wxSocketServer}{wxsocketserver} % --------------------------------------------------------------------------- % Members @@ -121,9 +127,9 @@ Returns a reference to the current object. \wxheading{See also} -\helpref{wxSocketBase::Error}{wxsocketbaseerror}, - \helpref{wxSocketBase::LastCount}{wxsocketbaselastcount}, - \helpref{wxSocketBase::LastError}{wxsocketbaselasterror} +\helpref{wxSocketBase::Error}{wxsocketbaseerror}\\ +\helpref{wxSocketBase::LastCount}{wxsocketbaselastcount}\\ +\helpref{wxSocketBase::LastError}{wxsocketbaselasterror} % % Read @@ -144,6 +150,20 @@ This function reads a buffer of {\it nbytes} bytes from the socket. Returns a reference to the current object. +\wxheading{Remark/Warning} + +By default, Read uses an internal asynchronous manager: it will send data when +the socket requests them. It is particularly interesting when you enter a long +data transfer (e.g. a big file, an image, ...). But it is also buggy when you +simply discuss with the peer using user data. In this case, wxSocket prepares +itself to send data (Write wait for them to be sent) and during a GUI refresh +the user enters new data, which involves a new Read call though the previous +isn't finished. Well, in most cases it can work but it might fail too. +So I advise you to use the SPEED flag, which disables the asynchronous manager, +when you just want to discuss with the peer. + +This remark is also valid for all IO call. + \wxheading{See also} \helpref{wxSocketBase::Error}{wxsocketbaseerror}, @@ -171,6 +191,18 @@ Returns a reference to the current object. This function writes a buffer of {\it nbytes} bytes from the socket. +\wxheading{Remark/Warning} + +By default, Write uses an internal asynchronous manager: it will send data when +the socket requests them. It is particularly interesting when you enter a long +data transfer (e.g. a big file, an image, ...). But it is also buggy when you +simply discuss with the peer using user data. In this case, wxSocket prepares +itself to send data (Write wait for them to be sent) and during a GUI refresh +the user enters new data, which involves a new Write call though the previous +isn't finished. Well, in most cases it can work but it might fail too. +So I advise you to use the SPEED flag, which disables the asynchronous manager, +when you just want to discuss with the peer. + \wxheading{Parameters} \docparam{buffer}{Buffer where to get the data to write.} @@ -183,9 +215,9 @@ Returns a reference to the current object. \wxheading{See also} -\helpref{wxSocketBase::Error}{wxsocketbaseerror}, - \helpref{wxSocketBase::LastCount}{wxsocketbaselastcount}, - \helpref{wxSocketBase::LastError}{wxsocketbaselasterror} +\helpref{wxSocketBase::Error}{wxsocketbaseerror}\\ +\helpref{wxSocketBase::LastCount}{wxsocketbaselastcount}\\ +\helpref{wxSocketBase::LastError}{wxsocketbaselasterror} % % WriteMsg @@ -210,10 +242,10 @@ Returns a reference to the current object. \wxheading{See also} -\helpref{wxSocketBase::Error}{wxsocketbaseerror}, - \helpref{wxSocketBase::LastCount}{wxsocketbaselastcount}, - \helpref{wxSocketBase::LastError}{wxsocketbaselasterror}, - \helpref{wxSocketBase::ReadMsg}{wxsocketbasereadmsg} +\helpref{wxSocketBase::Error}{wxsocketbaseerror}\\ +\helpref{wxSocketBase::LastCount}{wxsocketbaselastcount}\\ +\helpref{wxSocketBase::LastError}{wxsocketbaselasterror}\\ +\helpref{wxSocketBase::ReadMsg}{wxsocketbasereadmsg} % % ReadMsg @@ -238,10 +270,10 @@ Returns a reference to the current object. \wxheading{See also} -\helpref{wxSocketBase::Error}{wxsocketbaseerror}, - \helpref{wxSocketBase::LastCount}{wxsocketbaselastcount}, - \helpref{wxSocketBase::LastError}{wxsocketbaselasterror}, - \helpref{wxSocketBase::WriteMsg}{wxsocketbasewritemsg} +\helpref{wxSocketBase::Error}{wxsocketbaseerror}\\ +\helpref{wxSocketBase::LastCount}{wxsocketbaselastcount}\\ +\helpref{wxSocketBase::LastError}{wxsocketbaselasterror}\\ +\helpref{wxSocketBase::WriteMsg}{wxsocketbasewritemsg} % % Unread @@ -266,9 +298,9 @@ Returns a reference to the current object. \wxheading{See also} -\helpref{wxSocketBase::Error}{wxsocketbaseerror}, - \helpref{wxSocketBase::LastCount}{wxsocketbaselastcount}, - \helpref{wxSocketBase::LastError}{wxsocketbaselasterror} +\helpref{wxSocketBase::Error}{wxsocketbaseerror}\\ +\helpref{wxSocketBase::LastCount}{wxsocketbaselastcount}\\ +\helpref{wxSocketBase::LastError}{wxsocketbaselasterror} % % Discard @@ -303,9 +335,9 @@ Returns TRUE if an event occured, FALSE if the timeout was reached. \wxheading{See also} -\helpref{wxSocketBase::WaitForRead}{wxsocketbasewaitforread}, - \helpref{wxSocketBase::WaitForWrite}{wxsocketbasewaitforwrite}, - \helpref{wxSocketBase::WaitForLost}{wxsocketbasewaitforlost} +\helpref{wxSocketBase::WaitForRead}{wxsocketbasewaitforread}\\ +\helpref{wxSocketBase::WaitForWrite}{wxsocketbasewaitforwrite}\\ +\helpref{wxSocketBase::WaitForLost}{wxsocketbasewaitforlost} % % WaitForRead @@ -328,9 +360,9 @@ Returns TRUE if a byte arrived, FALSE if the timeout was reached. \wxheading{See also} -\helpref{wxSocketBase::Wait}{wxsocketbasewait}, - \helpref{wxSocketBase::WaitForWrite}{wxsocketbasewaitforwrite}, - \helpref{wxSocketBase::WaitForLost}{wxsocketbasewaitforlost} +\helpref{wxSocketBase::Wait}{wxsocketbasewait}\\ +\helpref{wxSocketBase::WaitForWrite}{wxsocketbasewaitforwrite}\\ +\helpref{wxSocketBase::WaitForLost}{wxsocketbasewaitforlost} % % WaitForWrite @@ -353,9 +385,9 @@ Returns TRUE if a write event occured, FALSE if the timeout was reached. \wxheading{See also} -\helpref{wxSocketBase::Wait}{wxsocketbasewait}, - \helpref{wxSocketBase::WaitForRead}{wxsocketbasewaitforread}, - \helpref{wxSocketBase::WaitForLost}{wxsocketbasewaitforlost} +\helpref{wxSocketBase::Wait}{wxsocketbasewait}\\ +\helpref{wxSocketBase::WaitForRead}{wxsocketbasewaitforread}\\ +\helpref{wxSocketBase::WaitForLost}{wxsocketbasewaitforlost} % % WaitForLost @@ -379,9 +411,9 @@ Returns TRUE if a "lost" event occured, FALSE if the timeout was reached. \wxheading{See also} -\helpref{wxSocketBase::WaitForRead}{wxsocketbasewaitforread}, - \helpref{wxSocketBase::WaitForWrite}{wxsocketbasewaitforwrite}, - \helpref{wxSocketBase::WaitForLost}{wxsocketbasewaitforlost} +\helpref{wxSocketBase::WaitForRead}{wxsocketbasewaitforread}\\ +\helpref{wxSocketBase::WaitForWrite}{wxsocketbasewaitforwrite}\\ +\helpref{wxSocketBase::WaitForLost}{wxsocketbasewaitforlost} % % RestoreState @@ -441,6 +473,10 @@ Sets an event handler to be called when a socket event occured. \helpref{wxSocketBase}{wxsocketbase} +\wxheading{Include files} + + + % --------------------------------------------------------------------------- % Members % --------------------------------------------------------------------------- @@ -453,7 +489,7 @@ Sets an event handler to be called when a socket event occured. Constructs a new wxSocketClient. -{\bf Warning !} The created socket client needs to be registered to a socket handler (See \helpref{wxSocketHandler}{wxsockethandler}). +{\bf Warning !} The new socket client needs to be registered to a socket handler (See \helpref{wxSocketHandler}{wxsockethandler}). \wxheading{Parameters} @@ -466,7 +502,7 @@ Constructs a new wxSocketClient. \func{}{\destruct{wxSocketClient}}{\void} -Destructs a wxSocketClient object. +Destroys a wxSocketClient object. % % Connect @@ -516,6 +552,10 @@ This event class contains information about socket events. \helpref{wxEvent}{wxevent} +\wxheading{Include files} + + + \wxheading{Event table macros} To process a socket event, use these event handler macros to direct input to member @@ -556,6 +596,10 @@ Returns the socket event type. \helpref{wxObject}{wxobject} +\wxheading{Include files} + + + % --------------------------------------------------------------------------- % Members % --------------------------------------------------------------------------- @@ -581,7 +625,7 @@ many sockets. \func{}{\destruct{wxSocketHandler}}{\void} -Destructs a wxSocketHandler object. +Destroys a wxSocketHandler object. % % Register @@ -705,6 +749,10 @@ Execute pending requests in all registered sockets. \helpref{wxSocketBase}{wxsocketbase} +\wxheading{Include files} + + + % --------------------------------------------------------------------------- % Members % --------------------------------------------------------------------------- @@ -735,7 +783,7 @@ Constructs a new wxSocketServer. \func{}{\destruct{wxSocketServer}}{\void} -Destructs a wxSocketServer object (it doesn't close the accepted connection). +Destroys a wxSocketServer object (it doesn't close the accepted connection). % % Accept @@ -772,4 +820,3 @@ This is useful when someone wants to inherit wxSocketBase. Returns TRUE if no error occurs, else FALSE. -