Method Stdio.File()->connect()
- Method connect
variant int connect(string host, int(0..)|string port)
variant int connect(string host, int(0..)|string port, string client, int(0..)|string client_port)
variant string connect(string host, int(0..)|string port, string data)
variant string connect(string host, int(0..)|string port, int(0..0)|string client, int(0..)|string client_port, string data)- Description
Open a TCP/IP connection to the specified destination.
In nonblocking mode, success is indicated with the write-callback, and failure with the close-callback or the read_oob-callback.
The host argument is the hostname or IP number of the remote machine.
A local IP and port can be explicitly bound by specifying client and client_port.
If the data argument is included the socket will use TCP_FAST_OPEN if posible. In this mode the the function will return the part of the data that has not been sent to the remote server yet instead of 1 (you will have to use write to send this data).
Note that TCP_FAST_OPEN requires server support, the connection might fail even though the remote server exists. It might be advicable to retry without TCP_FAST_OPEN (and remember this fact)
- Returns
This function returns 1 or the remaining data for success, 0 otherwise.
- Note
In nonblocking mode
0
(zero) may be returned and errno() set toEWOULDBLOCK
orWSAEWOULDBLOCK
.This should not be regarded as a connection failure. In nonblocking mode you need to wait for a write or close callback before you know if the connection failed or not.
- See also