SDL Wiki
(This function is part of SDL_net, a separate library from SDL.)


Bind an address to the requested channel on the UDP socket.

Header File

Defined in <SDL_net.h>


int SDLNet_UDP_Bind(UDPsocket sock, int channel, const IPaddress *address);

Function Parameters

UDPsocket sock the UDP socket to bind an address to a channel on.
int channel the channel of the socket to bind to, or -1 to use the first available channel.
const IPaddress * address the address to bind to the socket's channel.

Return Value

(int) Returns the channel which was bound, or -1 on error.


Note that UDP sockets at the platform layer "bind" to a nework port number, but SDL_net's UDP sockets also "bind" to a "channel" on top of that, with SDLNet_UDP_Bind(). But the term is used for both.

If channel is -1, then the first unbound channel that has not yet been bound to the maximum number of addresses will be bound with the given address as it's primary address.

If the channel is already bound, this new address will be added to the list of valid source addresses for packets arriving on the channel. If the channel is not already bound, then the address becomes the primary address, to which all outbound packets on the channel are sent.


This function is available since SDL_net 2.0.0.

See Also

CategoryAPI, CategoryAPIFunction

[ edit | delete | history | feedback | raw ]

[ front page | index | search | recent changes | git repo | offline html ]

All wiki content is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0).
Wiki powered by ghwikipp.