Documentation of SFML 2.3.1

Warning: this page refers to an old version of SFML. Click here to switch to the latest version.
TcpSocket.hpp
1 //
3 // SFML - Simple and Fast Multimedia Library
4 // Copyright (C) 2007-2015 Laurent Gomila (laurent@sfml-dev.org)
5 //
6 // This software is provided 'as-is', without any express or implied warranty.
7 // In no event will the authors be held liable for any damages arising from the use of this software.
8 //
9 // Permission is granted to anyone to use this software for any purpose,
10 // including commercial applications, and to alter it and redistribute it freely,
11 // subject to the following restrictions:
12 //
13 // 1. The origin of this software must not be misrepresented;
14 // you must not claim that you wrote the original software.
15 // If you use this software in a product, an acknowledgment
16 // in the product documentation would be appreciated but is not required.
17 //
18 // 2. Altered source versions must be plainly marked as such,
19 // and must not be misrepresented as being the original software.
20 //
21 // 3. This notice may not be removed or altered from any source distribution.
22 //
24 
25 #ifndef SFML_TCPSOCKET_HPP
26 #define SFML_TCPSOCKET_HPP
27 
29 // Headers
31 #include <SFML/Network/Export.hpp>
32 #include <SFML/Network/Socket.hpp>
33 #include <SFML/System/Time.hpp>
34 
35 
36 namespace sf
37 {
38 class TcpListener;
39 class IpAddress;
40 class Packet;
41 
46 class SFML_NETWORK_API TcpSocket : public Socket
47 {
48 public:
49 
54  TcpSocket();
55 
66  unsigned short getLocalPort() const;
67 
79  IpAddress getRemoteAddress() const;
80 
92  unsigned short getRemotePort() const;
93 
111  Status connect(const IpAddress& remoteAddress, unsigned short remotePort, Time timeout = Time::Zero);
112 
122  void disconnect();
123 
140  Status send(const void* data, std::size_t size);
141 
156  Status send(const void* data, std::size_t size, std::size_t& sent);
157 
174  Status receive(void* data, std::size_t size, std::size_t& received);
175 
192  Status send(Packet& packet);
193 
208  Status receive(Packet& packet);
209 
210 private:
211 
212  friend class TcpListener;
213 
218  struct PendingPacket
219  {
220  PendingPacket();
221 
222  Uint32 Size;
223  std::size_t SizeReceived;
224  std::vector<char> Data;
225  };
226 
228  // Member data
230  PendingPacket m_pendingPacket;
231 };
232 
233 } // namespace sf
234 
235 
236 #endif // SFML_TCPSOCKET_HPP
237 
238 
Socket that listens to new TCP connections.
Definition: TcpListener.hpp:43
Specialized socket using the TCP protocol.
Definition: TcpSocket.hpp:46
Status
Status codes that may be returned by socket functions.
Definition: Socket.hpp:53
Encapsulate an IPv4 network address.
Definition: IpAddress.hpp:44
Represents a time value.
Definition: Time.hpp:40
Utility class to build blocks of data to transfer over the network.
Definition: Packet.hpp:47
static const Time Zero
Predefined "zero" time value.
Definition: Time.hpp:85
Base class for all the socket types.
Definition: Socket.hpp:45