NET_GetStreamSocketAddress(3)

💖 NET_GetStreamSocketAddress 💖

okay bestie, this one lives in the SDL_net3 FUNCTIONS section of the manual, and it's genuinely one of the handiest little guys in the whole networking toolbox 🫶

---

✨ NAME ✨

NET_GetStreamSocketAddress — get the remote address of a stream socket. yes, the remote one, the other side of the call, the person on the phone 📞✨

---

🌸 SYNOPSIS 🌸

#include <SDL3_net/SDL_net.h>

NET_Address * NET_GetStreamSocketAddress(NET_StreamSocket *sock);

---

🦋 DESCRIPTION 🦋

So like. This function reports the address of the remote side of a stream socket. And here's the tea: that remote side might still be pending connection. Not fully connected yet, still getting ready, still doing its little warm-up stretch 🧚 — and this function will still tell you what address it's headed for.

💀 IMPORTANT BESTIE: this adds a reference to the address. That means the caller _must_ call NET_UnrefAddress() when done with it. Not "should", not "maybe", must. You took a reference, you give it back. No cap. 🙈

---

🎀 FUNCTION PARAMETERS 🎀

• sock — the stream socket to query. that's the one you're asking about 👑

---

⭐ RETURN VALUE ⭐

Returns the socket's remote address, or NULL on error — and if you get NULL, call SDL_GetError() for the details, because it will absolutely tell you what went wrong 🔍

---

🌈 THREAD SAFETY 🌈

It is safe to call this function from any thread. every thread. all of them. go wild, main character energy, no locks needed 💅✨

---

👑 AVAILABILITY 👑

This function is available since SDL_net 3.0.0. so if you're on something older… girl. upgrade. 🍓

---

and that's the whole page, mwah 💖 thanks for reading, you're doing amazing sweetie, now go unref that address 🫶

— with love from the SDL_net 3.2.0 era ✨🎀🦋 (that's the source + version stamped on this page, and if you were wondering about a date, bestie, the footer didn't give us one — just the version and that gorgeous SDL_net name 💜)