Net connect: Difference between revisions

From ENIGMA
Jump to navigation Jump to search
No edit summary
 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{FuncTitle|net_connect|addr,port,serve,udp}}
{{FuncTitle|net_connect|addr,port,server,udp}}
== Description ==
== Description ==
Initializes a socket as either a client or socket as UDP or TCP-IP using the given network address and port. Supports both IPv4 and IPv6, for clients the identifier indicates the server used for receiving messages. Returns an indentifier for the socket or negative on error.
Initializes a socket as either a client or socket as UDP or TCP-IP using the given network address and port. Supports both IPv4 and IPv6, for clients the identifier indicates the server used for receiving messages. Returns an indentifier for the socket or negative on error.<br>
''Note: Use 127.0.0.1 to connect the server internally as its own client''


== Parameters ==
== Parameters ==
{| class="funcpars"
{| class="funcpars"
! Parameter !! Description
! Parameter !! Data Type !! Description
|-
|-
| addr || string containing network address
| addr || string || network address
|-
|-
| port || string containing network port
| port || string || network port
|-
|-
| serve || boolean whether or not the socket is a server (true) or client (false)
| server || boolean || whether or not the socket is a server (true) or client (false)
|-
|-
| udp || boolean whether or not the connection is udp
| udp || boolean || whether or not the connection is udp (true) or tcp (false)
|}
|}


Line 21: Line 22:
== Example Call ==
== Example Call ==
<syntaxhighlight lang="edl">
<syntaxhighlight lang="edl">
// demonstrates opening a udp network connection
// demonstrates opening a udp network server socket connection
cid = net_connect("111.1.1.1", "100", false, true);
serversocketid = net_connect("0.0.0.0", "25565", false, true);
</syntaxhighlight>
</syntaxhighlight>


__NOTOC__
__NOTOC__
{{Function:ENIGMA}}
{{Function:ENIGMA}}

Latest revision as of 10:30, 29 June 2013

Description

Initializes a socket as either a client or socket as UDP or TCP-IP using the given network address and port. Supports both IPv4 and IPv6, for clients the identifier indicates the server used for receiving messages. Returns an indentifier for the socket or negative on error.
Note: Use 127.0.0.1 to connect the server internally as its own client

Parameters

Parameter Data Type Description
addr string network address
port string network port
server boolean whether or not the socket is a server (true) or client (false)
udp boolean whether or not the connection is udp (true) or tcp (false)

Return Values

integer: Returns the id of the socket or negative on error.

Example Call

// demonstrates opening a udp network server socket connection
serversocketid = net_connect("0.0.0.0", "25565", false, true);