sdlNetGetLocalAddresses function

Pointer<Pointer<SdlNetAddress>> sdlNetGetLocalAddresses(Pointer<Int32> numAddresses)

Obtain a list of local addresses on the system.

This returns addresses that you can theoretically bind a socket to, to accept connections from other machines at that address.

You almost never need this function; first, it's hard to tell what is a good address to bind to, without asking the user (who will likely find it equally hard to decide). Second, most machines will have lots of private addresses that are accessible on the same LAN, but not public ones that are accessible from the outside Internet.

Usually it's better to use SDLNet_CreateServer() or SDLNet_CreateDatagramSocket() with a NULL address, to say "bind to all interfaces."

The array of addresses returned from this is guaranteed to be NULL-terminated. You can also pass a pointer to an int, which will return the final count, not counting the NULL at the end of the array.

Pass the returned array to SDLNet_FreeLocalAddresses when you are done with it. It is safe to keep any addresses you want from this array even after calling that function, as long as you called SDLNet_RefAddress() on them.

\param num_addresses on exit, will be set to the number of addresses returned. Can be NULL. \returns A NULL-terminated array of SDLNet_Address pointers, one for each bindable address on the system, or NULL on error; call SDL_GetError() for details.

\threadsafety It is safe to call this function from any thread.

\since This function is available since SDL_Net 3.0.0.

extern SDL_DECLSPEC SDLNet_Address **SDLCALL SDLNet_GetLocalAddresses(int *num_addresses)

Implementation

Pointer<Pointer<SdlNetAddress>> sdlNetGetLocalAddresses(
    Pointer<Int32> numAddresses) {
  final sdlNetGetLocalAddressesLookupFunction = libSdl3Net.lookupFunction<
      Pointer<Pointer<SdlNetAddress>> Function(Pointer<Int32> numAddresses),
      Pointer<Pointer<SdlNetAddress>> Function(
          Pointer<Int32> numAddresses)>('SDLNet_GetLocalAddresses');
  return sdlNetGetLocalAddressesLookupFunction(numAddresses);
}