SDL_GetJoysticks(3)

✨ NAME ✨

SDL_GetJoysticks — bestie, this one gets you a list of every joystick that's currently connected 💖

🎀 SYNOPSIS 🎀

#include <SDL3/SDL_joystick.h>

SDL_JoystickID * SDL_GetJoysticks(int *count);

🌸 FUNCTION PARAMETERS 🌸

• count — a pointer that gets filled in with how many joysticks got returned. It's giving "optional", because it may be NULL. No pressure, no notes 💅

🦋 RETURN VALUE 🦋

Returns a 0 terminated array of joystick instance IDs — slay. But if it fails it returns NULL instead 😭, and in that case you gotta call SDL_GetError() for more info, fr fr.

Heads up bestie: when you're done with it, free it with SDL_free(). Don't just leave it lying around like an unread group chat 🙈

💜 THREAD SAFETY 💜

It is safe to call this function from any thread. Main character energy on every thread, no cap 👑

⭐ AVAILABILITY ⭐

This function is available since SDL 3.2.0. So if you're on anything older... it's not giving, sorry 🫶

🌈 SEE ALSO 🌈

• SDL_HasJoystick(3)
• SDL_OpenJoystick(3)

---

okay that's the whole page, go forth and enumerate your controllers, bestie 🎮✨

written under the Simple Directmedia Layer banner, SDL 3.4.18 era, and yes this manual page is literally called SDL_GetJoysticks(3) — iykyk 💖