3.6.5 SDLNet_CheckSockets

int SDLNet_CheckSockets(SDLNet_SocketSet set, Uint32 timeout)

set

The socket set to check

timeout

The amount of time (in milliseconds).
0 means no waiting.
-1 means to wait over 49 days! (think about it)

Check all sockets in the socket set for activity. If a non-zero timeout is given then this function will wait for activity, or else it will wait for timeout milliseconds.

NOTE: "activity" also includes disconnections and other errors, which would be determined by a failed read/write attempt.

Returns: the number of sockets with activity. -1 is returned on errors, and you may not get a meaningful error message. -1 is also returned for an empty set (nothing to check).

// Wait for up to 1 second for network activity //SDLNet_SocketSet set; int numready; numready=SDLNet_CheckSockets(set, 1000); if(numready==-1) { printf("SDLNet_CheckSockets: %s\n", SDLNet_GetError()); //most of the time this is a system error, where perror might help you. perror("SDLNet_CheckSockets"); } else if(numready) { printf("There are %d sockets with activity!\n",numready); // check all sockets with SDLNet_SocketReady and handle the active ones. }

See Also:
3.6.6 SDLNet_SocketReady, 3.6.3 SDLNet_AddSocket, 3.6.4 SDLNet_DelSocket, 3.6.1 SDLNet_AllocSocketSet, 4.5 SDLNet_SocketSet, 4.3 UDPsocket, 4.2 TCPsocket