SDL_GETJOYSTICKCONNECTIONSTATE(3)

✨ NAME ✨

SDL_GetJoystickConnectionState — bestie, this is literally the function that tells you the connection state of a joystick 💖

Like... is your controller plugged in? Bluetooth'd? Ghosted you? This is the girl who knows. 🎮✨

---

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_joystick.h>

SDL_JoystickConnectionState SDL_GetJoystickConnectionState(SDL_Joystick *joystick);

okay so you pull in <SDL3/SDL_joystick.h> and then you call the thing. That's it. That's the whole vibe. 🫶

---

🎀 FUNCTION PARAMETERS 🎀

• joystick — the joystick to query. yes queen, the one you wanna ask about 👑 just hand her over and she'll spill the tea on her own connection status.

---

💅 RETURN VALUE 💅

On success she gives you the connection state, no cap. 🦋

On failure? SDL_JOYSTICK_CONNECTION_INVALID 😭 it's giving "she's not telling you anything."

if that happens, hit up SDL_GetError() for more info — she'll explain herself, fr fr.

---

🌈 THREAD SAFETY 🌈

It is safe to call this function from any thread. ✨

not me being fully portable across every thread like the main character she is 💅 no locks, no drama, no vibe check failures. iconic behavior, periodt. 💖

---

⭐ AVAILABILITY ⭐

This function has been available since SDL 3.2.0. 🎀

so if you're on anything older... bestie, upgrade. 🙈

---

and that's the whole page, mwah 💜

this lil masterpiece lives in the Simple Directmedia Layer docs, brought to you by SDL 3.4.18 — thanks for reading, ily, go make something slay 🔥👑