Documentation of SFML 2.4.0

Warning: this page refers to an old version of SFML. Click here to switch to the latest version.
UdpSocket.hpp
1 //
3 // SFML - Simple and Fast Multimedia Library
4 // Copyright (C) 2007-2016 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_UDPSOCKET_HPP
26 #define SFML_UDPSOCKET_HPP
27 
29 // Headers
31 #include <SFML/Network/Export.hpp>
32 #include <SFML/Network/Socket.hpp>
33 #include <SFML/Network/IpAddress.hpp>
34 #include <vector>
35 
36 
37 namespace sf
38 {
39 class Packet;
40 
45 class SFML_NETWORK_API UdpSocket : public Socket
46 {
47 public:
48 
50  // Constants
52  enum
53  {
54  MaxDatagramSize = 65507
55  };
56 
61  UdpSocket();
62 
74  unsigned short getLocalPort() const;
75 
93  Status bind(unsigned short port, const IpAddress& address = IpAddress::Any);
94 
105  void unbind();
106 
124  Status send(const void* data, std::size_t size, const IpAddress& remoteAddress, unsigned short remotePort);
125 
147  Status receive(void* data, std::size_t size, std::size_t& received, IpAddress& remoteAddress, unsigned short& remotePort);
148 
165  Status send(Packet& packet, const IpAddress& remoteAddress, unsigned short remotePort);
166 
182  Status receive(Packet& packet, IpAddress& remoteAddress, unsigned short& remotePort);
183 
184 private:
185 
187  // Member data
189  std::vector<char> m_buffer;
190 };
191 
192 } // namespace sf
193 
194 
195 #endif // SFML_UDPSOCKET_HPP
196 
197 
Status
Status codes that may be returned by socket functions.
Definition: Socket.hpp:53
Encapsulate an IPv4 network address.
Definition: IpAddress.hpp:44
Utility class to build blocks of data to transfer over the network.
Definition: Packet.hpp:47
Specialized socket using the UDP protocol.
Definition: UdpSocket.hpp:45
Base class for all the socket types.
Definition: Socket.hpp:45
static const IpAddress Any
Value representing any address (0.0.0.0)
Definition: IpAddress.hpp:185