SDL_GetJoystickTypeForID(3)

📦
version 3.4.18 · 9 versions
, in fedora 43, fedora 44

💖 SDL_GetJoystickTypeForID 💖

okay bestie, welcome to the SDL3 FUNCTIONS corner of the manual, this one is literally called SDL_GetJoystickTypeForID and it's giving "who is this joystick and what IS she" energy ✨

🌸 NAME 🌸

SDL_GetJoystickTypeForID — get the type of a joystick, if available. no cap, that's the whole job 🎮

🦋 SYNOPSIS 🦋

#include <SDL3/SDL_joystick.h>

SDL_JoystickType SDL_GetJoystickTypeForID(SDL_JoystickID instance_id);

💅 DESCRIPTION 💅

the tea is: you can call this before any joysticks are opened. like, before. zero setup, zero open, just vibes and an ID. it's giving main character energy because it doesn't need the whole joystick subsystem awake first 🫶

🎀 FUNCTION PARAMETERS 🎀

  • instance_id — the joystick instance ID. that's it, that's the whole parameter, she's lowkey simple 💜

⭐ RETURN VALUE ⭐

returns the SDL_JoystickType of the selected joystick. iconic. correct. slay.

but bestie, if you hand her an invalid instance_id, she doesn't guess, she doesn't improvise — she returns SDL_JOYSTICK_TYPE_UNKNOWN. so if you get that back, double check your ID, fr fr 😭

🧚 THREAD SAFETY 🧚

it is safe to call this function from any thread. any thread. all the threads. go wild, she can handle it 🔥

🌈 AVAILABILITY 🌈

this function is available since SDL 3.2.0. if you're on something older, sorry bestie, she wasn't born yet 🙈

👑 SEE ALSO 👑

and that's the whole page, periodt 💅

Simple Directmedia Layer — SDL 3.4.18 — SDL_GetJoystickTypeForID(3) 🦋💖 go check the type of that joystick, you absolute icon ✨

📦 where this page comes from