SDL_GetNumJoystickAxes(3)

💖 SDL_GetNumJoystickAxes 💖

okay bestie, welcome to the SDL3 FUNCTIONS corner of the manual, page SDL_GetNumJoystickAxes(3). this one's a lil cutie — it literally just tells you how many axes your joystick has. no cap. let's get into it ✨

---

✨ NAME ✨

SDL_GetNumJoystickAxes — get the number of general axis controls on a joystick.

like. how many wiggly directions does this thing have. that's the whole vibe. 🎀

---

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_joystick.h>

int SDL_GetNumJoystickAxes(SDL_Joystick *joystick);

---

🦋 DESCRIPTION 🦋

so here's the tea, and it's lowkey important: often, the directional pad on a game controller will either look like 4 separate buttons or a POV hat, and not axes. but all of this is up to the device and platform. 🙈

translation: don't just assume the d-pad is gonna show up as axes, because it might not, and whether it does is entirely between your device and your platform. it's giving "it depends" energy. 💅

---

🎀 FUNCTION PARAMETERS 🎀

• joystick — an SDL_Joystick structure containing joystick information. that's your lil guy. your controller bestie. hand it over. 🫶

---

⭐ RETURN VALUE ⭐

Returns the number of axis controls / number of axes on success, or -1 on failure. 😭

if you got -1, don't panic — call SDL_GetError() for more information. it will tell you what went wrong, fr fr.

---

🔥 THREAD SAFETY 🔥

It is safe to call this function from any thread. periodt. 👑

---

🌈 AVAILABILITY 🌈

This function is available since SDL 3.2.0. so if you're on something older... yeah, she's not there yet. 💀

---

💜 SEE ALSO 💜

• SDL_GetJoystickAxis(3)
• SDL_GetNumJoystickBalls(3)
• SDL_GetNumJoystickButtons(3)
• SDL_GetNumJoystickHats(3)

go read those too, they're all part of the same friend group 🧚

---

ok that's the whole page, no notes. go count some axes. 🍓

this has been your girlie from Simple Directmedia Layer, reporting live from SDL 3.4.18 — stay iconic, mwah 💅💖✨