X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/7c395bf3a19bcd0d749b9cd2dad4601f590961dc..dff873d1aaeaab36167f66bb0c993735d954d733:/include/wx/socket.h diff --git a/include/wx/socket.h b/include/wx/socket.h index d74c44d296..4663b0d6ed 100644 --- a/include/wx/socket.h +++ b/include/wx/socket.h @@ -23,6 +23,7 @@ // --------------------------------------------------------------------------- // wxSocket headers (generic) // --------------------------------------------------------------------------- + #ifdef WXPREC # include "wx/wxprec.h" #else @@ -34,17 +35,19 @@ #include "wx/gsocket.h" // ------------------------------------------------------------------------ -// GSocket type alias +// constants // ------------------------------------------------------------------------ -typedef enum { +enum wxSocketNotify +{ wxSOCKET_INPUT = GSOCK_INPUT, wxSOCKET_OUTPUT = GSOCK_OUTPUT, wxSOCKET_CONNECTION = GSOCK_CONNECTION, wxSOCKET_LOST = GSOCK_LOST -} wxSocketNotify; +}; -enum { +enum +{ wxSOCKET_INPUT_FLAG = GSOCK_INPUT_FLAG, wxSOCKET_OUTPUT_FLAG = GSOCK_OUTPUT_FLAG, wxSOCKET_CONNECTION_FLAG = GSOCK_CONNECTION_FLAG, @@ -53,7 +56,8 @@ enum { typedef GSocketEventFlags wxSocketEventFlags; -typedef enum { +enum wxSocketError +{ wxSOCKET_NOERROR = GSOCK_NOERROR, wxSOCKET_INPOP = GSOCK_INVOP, wxSOCKET_IOERR = GSOCK_IOERR, @@ -63,8 +67,29 @@ typedef enum { wxSOCKET_INVPORT = GSOCK_INVPORT, wxSOCKET_WOULDBLOCK = GSOCK_WOULDBLOCK, wxSOCKET_TIMEDOUT = GSOCK_TIMEDOUT, - wxSOCKET_MEMERR = GSOCK_MEMERR -} wxSocketError; + wxSOCKET_MEMERR = GSOCK_MEMERR, + wxSOCKET_BUSY +}; + +enum +{ + wxSOCKET_NONE = 0, + wxSOCKET_NOWAIT = 1, + wxSOCKET_WAITALL = 2, + wxSOCKET_BLOCK = 4 +}; + +// Type of socket +enum wxSockType +{ + SOCK_CLIENT, + SOCK_SERVER, + SOCK_DATAGRAM, + SOCK_INTERNAL, + SOCK_UNINIT +}; + +typedef int wxSockFlags; // ------------------------------------------------------------------------ // wxSocket base @@ -72,48 +97,52 @@ typedef enum { class WXDLLEXPORT wxTimer; class WXDLLEXPORT wxSocketEvent; + class WXDLLEXPORT wxSocketBase : public wxEvtHandler { DECLARE_CLASS(wxSocketBase) public: - enum { NONE=0, NOWAIT=1, WAITALL=2, SPEED=4 }; - typedef int wxSockFlags; - // Type of request + enum + { + NONE = wxSOCKET_NONE, + NOWAIT = wxSOCKET_NOWAIT, + WAITALL = wxSOCKET_WAITALL, + SPEED = wxSOCKET_BLOCK + }; - enum wxSockType { SOCK_CLIENT, SOCK_SERVER, SOCK_INTERNAL, SOCK_UNINIT }; typedef void (*wxSockCbk)(wxSocketBase& sock, wxSocketNotify evt, char *cdata); protected: - GSocket *m_socket; // wxSocket socket - wxSockFlags m_flags; // wxSocket flags - wxSockType m_type; // wxSocket type - wxSocketEventFlags m_neededreq; // Which events we are interested in - wxUint32 m_lcount; // Last IO request size - unsigned long m_timeout; // IO timeout value - - char *m_unread; // Pushback buffer - wxUint32 m_unrd_size; // Pushback buffer size - wxUint32 m_unrd_cur; // Pushback pointer - - wxSockCbk m_cbk; // C callback - char *m_cdata; // C callback data - - bool m_connected; // Connected ? - bool m_establishing; // Pending connections ? - bool m_notify_state; // Notify state - int m_id; // Socket id (for event handler) - - // Defering variables - enum { - DEFER_READ, DEFER_WRITE, NO_DEFER - } m_defering; // Defering state - char *m_defer_buffer; // Defering target buffer - wxUint32 m_defer_nbytes; // Defering buffer size - wxTimer *m_defer_timer; // Timer for defering mode - - bool m_error; // Did an error occur in last IO call ? - wxList m_states; // Stack of states + GSocket *m_socket; // GSocket + wxEvtHandler *m_evt_handler; // event handler + int m_id; // Socket id (for event handler) + + // Attributes + wxSockFlags m_flags; // wxSocket flags + wxSockType m_type; // wxSocket type + wxSocketEventFlags m_neededreq; // Event mask + bool m_notify_state; // Notify events to users? + + // State + bool m_connected; // Connected? + bool m_establishing; // Establishing connection? + bool m_reading; // Busy reading? + bool m_writing; // Busy writing? + bool m_error; // Did last IO call fail? + wxUint32 m_lcount; // Last IO transaction size + unsigned long m_timeout; // IO timeout value + wxList m_states; // Stack of states + bool m_interrupt; // Interrupt ongoing wait operations + + // Pushback buffer + char *m_unread; // Pushback buffer + wxUint32 m_unrd_size; // Pushback buffer size + wxUint32 m_unrd_cur; // Pushback pointer (index into buffer) + + // Callback + wxSockCbk m_cbk; // C callback + char *m_cdata; // C callback data public: wxSocketBase(); @@ -127,7 +156,7 @@ public: wxSocketBase& Unread(const char *buffer, wxUint32 nbytes); wxSocketBase& ReadMsg(char *buffer, wxUint32 nbytes); wxSocketBase& WriteMsg(const char *buffer, wxUint32 nbytes); - void Discard(); + wxSocketBase& Discard(); // Status inline bool Ok() const { return (m_socket != NULL); }; @@ -135,29 +164,37 @@ public: inline bool IsConnected() const { return m_connected; }; inline bool IsDisconnected() const { return !IsConnected(); }; inline bool IsNoWait() const { return ((m_flags & NOWAIT) != 0); }; - bool IsData() const; + inline bool IsData() { return WaitForRead(0, 0); }; inline wxUint32 LastCount() const { return m_lcount; } inline wxSocketError LastError() const { return (wxSocketError)GSocket_GetError(m_socket); } inline wxSockType GetType() const { return m_type; } - // Some info on the socket... + // Addresses virtual bool GetPeer(wxSockAddress& addr_man) const; virtual bool GetLocal(wxSockAddress& addr_man) const; // Set attributes and flags - void SetFlags(wxSockFlags _flags); - wxSockFlags GetFlags() const; void SetTimeout(long seconds); - - // Wait functions - // seconds = -1 means default timeout (change with SetTimeout) - // seconds, milliseconds = 0 means no wait - // seconds, milliseconds > 0 means specified wait + void SetFlags(wxSockFlags flags); + inline wxSockFlags GetFlags() const { return m_flags; }; + + /* Wait functions + * seconds = -1 means default timeout (change with SetTimeout) + * seconds, milliseconds = 0 means no wait + * seconds, milliseconds > 0 means specified wait + */ bool Wait(long seconds = -1, long milliseconds = 0); bool WaitForRead(long seconds = -1, long milliseconds = 0); bool WaitForWrite(long seconds = -1, long milliseconds = 0); bool WaitForLost(long seconds = -1, long milliseconds = 0); + /* This function interrupts all ongoing wait operations for this + * socket; use it only as an escape mechanism (for example to close + * an app or to abort an operation). Reception of LOST events and + * calls to Close() automatically call this. + */ + void InterruptAllWaits() { m_interrupt = TRUE; }; + // Save the current state of Socket void SaveState(); void RestoreState(); @@ -178,9 +215,7 @@ public: // Public internal callback virtual void OldOnNotify(wxSocketNotify WXUNUSED(evt)); - // Do NOT use these functions; they should be protected! - void CreatePushbackAfter(const char *buffer, wxUint32 size); - void CreatePushbackBefore(const char *buffer, wxUint32 size); + // Do NOT use this function; it should be protected! void OnRequest(wxSocketNotify req_evt); protected: @@ -198,13 +233,13 @@ public: protected: #endif + // Low level IO + wxUint32 _Read(char* buffer, wxUint32 nbytes); + wxUint32 _Write(const char *buffer, wxUint32 nbytes); bool _Wait(long seconds, long milliseconds, wxSocketEventFlags flags); - int DeferRead(char *buffer, wxUint32 nbytes); - int DeferWrite(const char *buffer, wxUint32 nbytes); - void DoDefer(); - - // Pushback library + // Pushbacks + void Pushback(const char *buffer, wxUint32 size); wxUint32 GetPushback(char *buffer, wxUint32 size, bool peek); }; @@ -216,7 +251,7 @@ class WXDLLEXPORT wxSocketServer : public wxSocketBase public: // 'service' can be a name or a port-number - wxSocketServer(wxSockAddress& addr_man, wxSockFlags flags = wxSocketBase::NONE); + wxSocketServer(wxSockAddress& addr_man, wxSockFlags flags = wxSOCKET_NONE); wxSocketBase* Accept(bool wait = TRUE); bool AcceptWith(wxSocketBase& sock, bool wait = TRUE); @@ -231,7 +266,7 @@ class WXDLLEXPORT wxSocketClient : public wxSocketBase DECLARE_CLASS(wxSocketClient) public: - wxSocketClient(wxSockFlags flags = wxSocketBase::NONE); + wxSocketClient(wxSockFlags flags = wxSOCKET_NONE); virtual ~wxSocketClient(); virtual bool Connect(wxSockAddress& addr_man, bool wait = TRUE); @@ -239,6 +274,25 @@ public: bool WaitOnConnect(long seconds = -1, long milliseconds = 0); }; +//////////////////////////////////////////////////////////////////////// + +class wxDatagramSocket : public wxSocketBase +{ + DECLARE_CLASS(wxDatagramSocket) + +public: + wxDatagramSocket( wxSockAddress& addr, wxSockFlags flags = wxSOCKET_NONE ); + + wxDatagramSocket& RecvFrom( wxSockAddress& addr, + char* buf, + wxUint32 nBytes ); + wxDatagramSocket& SendTo( wxSockAddress& addr, + const char* buf, + wxUint32 nBytes ); +}; + +//////////////////////////////////////////////////////////////////////// + class WXDLLEXPORT wxSocketEvent : public wxEvent { DECLARE_DYNAMIC_CLASS(wxSocketEvent) public: