SDL_Function

Name

SDLNet_TCP_Open -- Connect to the host and port using a TCP connection.

Synopsis

TCPsocket SDLNet_TCP_Open(IPaddress *ip);

ip This points to the IPaddress that contains the resolved IP address and port number to use.

Description

Connect to the host and port contained in ip using a TCP connection. If the host is INADDR ANY, then only the port number is used, and a socket is created that can be used to later accept incoming TCP connections.

Return Value

Returns: a valid TCPsocket on success, which indicates a successful connection has been established, or a socket has been created that is valid to accept incoming TCP connections. NULL is returned on errors, such as when itÂ’s not able to create a socket, or it cannot connect to host and/or port contained in ip.

Example

To connect to localhost at port 9999 using TCP (client):

IPaddress ip;
TCPsocket tcpsock;
if(SDLNet_ResolveHost(&ip,"localhost",9999)==-1) {
   printf("SDLNet_ResolveHost: %s\n", SDLNet_GetError());
   exit(1);
}
tcpsock=SDLNet_TCP_Open(&ip);
if(!tcpsock) {
   printf("SDLNet_TCP_Open: %s\n", SDLNet_GetError());
   exit(2);
}

To create a listening TCP socket on port 9999 (server):

IPaddress ip;
TCPsocket tcpsock;
if(SDLNet_ResolveHost(&ip,NULL,9999)==-1) {
   printf("SDLNet_ResolveHost: %s\n", SDLNet_GetError());
   exit(1);
}
tcpsock=SDLNet_TCP_Open(&ip);
if(!tcpsock) {
   printf("SDLNet_TCP_Open: %s\n", SDLNet_GetError());
   exit(2);
}

See Also

SDLNet_TCP_Accept, SDLNet_TCP_Close, IPaddress, TCPsocket

SDLNet_TCP_Open (last edited 2008-04-17 08:18:08 by localhost)