Gamedev Framework (gf)  0.17.0
A C++14 framework for 2D games
TcpSocket.h
1 /*
2  * Gamedev Framework (gf)
3  * Copyright (C) 2016-2019 Julien Bernard
4  *
5  * This software is provided 'as-is', without any express or implied
6  * warranty. In no event will the authors be held liable for any damages
7  * 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
11  * freely, subject to the following restrictions:
12  *
13  * 1. The origin of this software must not be misrepresented; you must not
14  * claim that you wrote the original software. If you use this software
15  * in a product, an acknowledgment in the product documentation would be
16  * appreciated but is not required.
17  * 2. Altered source versions must be plainly marked as such, and must not be
18  * misrepresented as being the original software.
19  * 3. This notice may not be removed or altered from any source distribution.
20  */
21 #ifndef GF_TCP_SOCKET_H
22 #define GF_TCP_SOCKET_H
23 
24 #include <cstdint>
25 #include <string>
26 
27 #include "ArrayRef.h"
28 #include "BufferRef.h"
29 #include "Portability.h"
30 #include "Socket.h"
31 
32 namespace gf {
33 #ifndef DOXYGEN_SHOULD_SKIP_THIS
34 inline namespace v1 {
35 #endif
36  struct Packet;
37 
51  class GF_API TcpSocket : public Socket {
52  public:
58  TcpSocket() = default;
59 
67  TcpSocket(const std::string& hostname, const std::string& service, SocketFamily family = SocketFamily::Unspec);
68 
72  TcpSocket(const TcpSocket&) = delete;
73 
77  TcpSocket& operator=(const TcpSocket&) = delete;
78 
82  TcpSocket(TcpSocket&&) = default;
83 
87  TcpSocket& operator=(TcpSocket&&) = default;
88 
94  ~TcpSocket();
95 
99  SocketAddress getRemoteAddress() const;
100 
108 
115  SocketDataResult recvRawBytes(BufferRef<uint8_t> buffer);
116 
125  SocketStatus sendBytes(ArrayRef<uint8_t> buffer);
126 
136  SocketStatus recvBytes(BufferRef<uint8_t> buffer);
137 
144  SocketStatus sendPacket(const Packet& packet);
145 
152  SocketStatus recvPacket(Packet& packet);
153 
154  private:
155  TcpSocket(SocketHandle handle);
156 
157  friend class TcpListener;
158 
159  private:
160  static SocketHandle nativeConnect(const std::string& host, const std::string& service, SocketFamily family);
161  };
162 
163 #ifndef DOXYGEN_SHOULD_SKIP_THIS
164 }
165 #endif
166 }
167 
168 #endif // GF_TCP_SOCKET_H
SocketFamily
A socket family.
Definition: SocketAddress.h:50
The result of a socket operation.
Definition: Socket.h:97
A TCP listener.
Definition: TcpListener.h:58
Unspecified (either IPv4 or IPv6)
constexpr BufferRef< T > buffer(T *data, std::size_t size)
Create a reference to a buffer.
Definition: BufferRef.h:211
A packet of bytes.
Definition: Packet.h:44
The namespace for gf classes.
Definition: Action.h:35
A TCP socket.
Definition: TcpSocket.h:51
SocketStatus
The status of a socket operation.
Definition: Socket.h:84
implementation-defined SocketHandle
A native socket handle.
Definition: Socket.h:63
A network socket.
Definition: Socket.h:109
A socket address.
Definition: SocketAddress.h:78