NET_GetAddressStatus(3)

💖 NET_GetAddressStatus(3) 💖

okay bestie, welcome to the SDL_net3 section of the manual, and today we're talking about NET_GetAddressStatus — the little function that lets you peek at your DNS resolution like a nosy queen without ever getting stuck waiting. 🕵️♀️✨

---

✨ NAME ✨

NET_GetAddressStatus — check if an address is resolved, without blocking. 💅

---

🌸 SYNOPSIS 🌸

#include <SDL3_net/SDL_net.h>

NET_Status NET_GetAddressStatus(NET_Address *address);

---

🦋 DESCRIPTION 🦋

so here's the tea ☕: the NET_Address objects you get back from NET_ResolveHostname take time to do their thing. like, actual real-world time, because DNS is out here living its life. so instead of making your whole program sit there waiting an indefinite amount of time like a sad little NPC, it does its work asynchronously. 🫶

this function right here? it lets you check the progress of that work without blocking. literally just a little vibe check on your address. 🔍

⚠️ important bestie: resolution can fail after some time (DNS server took a while to reply that the hostname isn't recognized, etc.), so be sure to check the result of this function instead of just assuming it worked because it's non-zero! 😭 no cap, that's how you get bugs.

once an address is successfully resolved, it can be used to connect to the host represented by the address. periodt. 👑

---

🎀 FUNCTION PARAMETERS 🎀

• address — the NET_Address you wanna query. that's it, that's the whole vibe. 💖

---

⭐ RETURN VALUE ⭐

• NET_SUCCESS — yay! successfully resolved. slay. ✨
• NET_FAILURE — resolution failed. 💀 if you get this, call SDL_GetError() for details.
• NET_WAITING — still resolving, bestie. this function timed out without resolution. give it a sec. ⏳

---

🔥 THREAD SAFETY 🔥

it is safe to call this function from any thread. go off, multithreaded icon. 🧵👑

---

🌈 AVAILABILITY 🌈

this function is available since SDL_net 3.0.0. vintage but make it fresh. 💜

---

👑 SEE ALSO 👑

• NET_WaitUntilResolved(3) — the patient bestie who actually waits. 🫶

---

mwah 💋 that's the whole page, diva. this was SDL_net 3.2.0, brought to you by the SDL_net girlies, and you absolutely ate this documentation. no notes. 🎀✨🦋