File: ags_sock.h

package info (click to toggle)
scummvm 2.9.1%2Bdfsg-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 450,580 kB
  • sloc: cpp: 4,299,825; asm: 28,322; python: 12,901; sh: 11,302; java: 9,289; xml: 7,895; perl: 2,639; ansic: 2,465; yacc: 1,670; javascript: 1,020; makefile: 933; lex: 578; awk: 275; objc: 82; sed: 11; php: 1
file content (306 lines) | stat: -rw-r--r-- 7,567 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
/* ScummVM - Graphic Adventure Engine
 *
 * ScummVM is the legal property of its developers, whose names
 * are too numerous to list here. Please refer to the COPYRIGHT
 * file distributed with this source distribution.
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * of the License, or(at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 *
 */

#ifndef AGS_PLUGINS_AGS_SOCK_H
#define AGS_PLUGINS_AGS_SOCK_H

#include "ags/plugins/ags_plugin.h"

namespace AGS3 {
namespace Plugins {
namespace AGSSock {

class AGSSock : public PluginBase {
	SCRIPT_HASH(AGSSock)
private:
	Common::String _text;

	/**
	 * Creates a new data container with specified size
	 * (and what character to fill it with)
	 */
	void SockData_Create(ScriptMethodParams &params);

	/**
	 * Creates a new data container of zero size
	 */
	void SockData_CreateEmpty(ScriptMethodParams &params);

	/**
	 * Creates a data container from a string
	 */
	void SockData_CreateFromString(ScriptMethodParams &params);

	/**
	 * Gets the size property
	 */
	void SockData_get_Size(ScriptMethodParams &params);

	/**
	 * Sets the size property
	 */
	void SockData_set_Size(ScriptMethodParams &params);

	/**
	 * Gets the chars array
	 */
	void SockData_geti_Chars(ScriptMethodParams &params);

	/**
	 * Sets the chars array
	 */
	void SockData_seti_Chars(ScriptMethodParams &params);

	/**
	 * Makes and returns a string from the data object.
	 * (Warning: anything after a null character will be truncated)
	 */
	void SockData_AsString(ScriptMethodParams &params);

	/**
	 * Removes all the data from a socket data object,
	 * reducing it's size to zero
	 */
	void SockData_Clear(ScriptMethodParams &params);

	/**
	 * Creates an empty socket address. (advanced: set type
	 * to IPv6 if you're using IPv6)
	 */
	void SockAddr_Create(ScriptMethodParams &params);

	/**
	 * Creates a socket address from a string.
	 * (for example: "https://www.scummvm.org/"
	 */
	void SockAddr_CreateFromString(ScriptMethodParams &params);

	/**
	 * Creates a socket address from raw data. (advanced)
	 */
	void SockAddr_CreateFromData(ScriptMethodParams &params);

	/**
	 * Creates a socket address from an IP-address.
	 * (for example: "127.0.0.1")
	 */
	void SockAddr_CreateIP(ScriptMethodParams &params);

	/**
	 * Creates a socket address from an IPv6-address.
	 * (for example: "::1")
	 */
	void SockAddr_CreateIPv6(ScriptMethodParams &params);

	/**
	 * Gets the value of the port property
	 */
	void SockAddr_get_Port(ScriptMethodParams &params);

	/**
	 * Sets the value of the port property
	 */
	void SockAddr_set_Port(ScriptMethodParams &params);

	/**
	 * Gets the value of the address property
	 */
	void SockAddr_get_Address(ScriptMethodParams &params);

	/**
	 * Sets the value of the address property
	 */
	void SockAddr_set_Address(ScriptMethodParams &params);

	/**
	 * Gets the value of the IP property
	 */
	void SockAddr_get_IP(ScriptMethodParams &params);

	/**
	 * Sets the value of the IP property
	 */
	void SockAddr_set_IP(ScriptMethodParams &params);

	/**
	 * Returns a SockData object that contains the raw data
	 * of the socket address. (advanced)
	 */
	void SockAddr_GetData(ScriptMethodParams &params);

	/**
	 * Creates a socket for the specified protocol. (advanced)
	 */
	void Socket_Create(ScriptMethodParams &params);

	/**
	 * Creates a UDP socket. (unrealiable, connectionless, message based)
	 */
	void Socket_CreateUDP(ScriptMethodParams &params);

	/**
	 * Creates a TCP socket. (reliable, connection based, streaming)
	 */
	void Socket_CreateTCP(ScriptMethodParams &params);

	/**
	 * Creates a UDP socket for IPv6. (when in doubt use CreateUDP)
	 */
	void Socket_CreateUDPv6(ScriptMethodParams &params);

	/**
	 * Creates a TCP socket for IPv6. (when in doubt use CreateTCP)
	 */
	void Socket_CreateTCPv6(ScriptMethodParams &params);

	/**
	 * Gets the value of the Tag property
	 */
	void Socket_get_Tag(ScriptMethodParams &params);

	/**
	 * Sets the value of the Tag property
	 */
	void Socket_set_Tag(ScriptMethodParams &params);

	/**
	 * Gets the value of the Local property
	 */
	void Socket_get_Local(ScriptMethodParams &params);

	/**
	 * Gets the value of the Remote property
	 */
	void Socket_get_Remote(ScriptMethodParams &params);

	/**
	 * Gets the value of the Value property
	 */
	void Socket_get_Valid(ScriptMethodParams &params);

	/**
	 * Returns the last error observed from this socket
	 * as an human readable string
	 */
	void Socket_ErrorString(ScriptMethodParams &params);

	/**
	 * Binds the socket to a local address. (generally used
	 * before listening)
	 */
	void Socket_Bind(ScriptMethodParams &params);

	/**
	 * Makes a socket listen for incoming connection requests.
	 * (TCP only) Backlog specifies how many requests can be
	 * queued. (optional)
	 */
	void Socket_Listen(ScriptMethodParams &params);

	/**
	 * Makes a socket connect to a remote host. (for UDP it
	 * will simply bind to a remote address) Defaults to sync
	 * which makes it wait; see the manual for async use.
	 */
	void Socket_Connect(ScriptMethodParams &params);

	/**
	 * Accepts a connection request and returns the resulting
	 * socket when successful. (TCP only)
	 */
	void Socket_Accept(ScriptMethodParams &params);

	/**
	 * Closes the socket. (you can still receive until socket
	 * is marked invalid
	 */
	void Socket_Close(ScriptMethodParams &params);

	/**
	 * Sends a string to the remote host. Returns whether
	 * successful. (no error means: try again later)
	 */
	void Socket_Send(ScriptMethodParams &params);

	/**
	 * Sends a string to the specified remote host. (UDP only)
	 */
	void Socket_SendTo(ScriptMethodParams &params);

	/**
	 * Receives a string from the remote host. (no error
	 * means: try again later)
	 */
	void Socket_Recv(ScriptMethodParams &params);

	/**
	 * Receives a string from an unspecified host. The given
	 * address object will contain the remote address. (UDP only)
	 */
	void Socket_RecvFrom(ScriptMethodParams &params);

	/**
	 * Sends raw data to the remote host. Returns whether
	 * successful. (no error means: try again later
	 */
	void Socket_SendData(ScriptMethodParams &params);

	/**
	 * Sends raw data to the specified remote host. (UDP only)
	 */
	void Socket_SendDataTo(ScriptMethodParams &params);

	/**
	 * Receives raw data from the remote host. (no error
	 * means: try again later
	 */
	void Socket_RecvData(ScriptMethodParams &params);

	/**
	 * Receives raw data from an unspecified host. The given
	 * address object will contain the remote address. (UDP only)
	 */
	void Socket_RecvDataFrom(ScriptMethodParams &params);

	/**
	 * Gets a socket option. (advanced)
	 */
	void Socket_GetOption(ScriptMethodParams &params);

	/**
	 * Sets a socket option. (advanced)
	 */
	void Socket_SetOption(ScriptMethodParams &params);

public:
	AGSSock() : PluginBase() {}
	virtual ~AGSSock() {}

	const char *AGS_GetPluginName() override;
	void AGS_EngineStartup(IAGSEngine *engine) override;

};

} // namespace AGSSock
} // namespace Plugins
} // namespace AGS3

#endif