SDL_GetJoystickGUIDForID(3)

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

💖 SDL_GetJoystickGUIDForID 💖

okay bestie, welcome to the SDL3 FUNCTIONS corner of the manual, where we're talking about SDL_GetJoystickGUIDForID — yes that whole mouthful — and it's literally the glow-up you need if you wanna know which joystick is which. 🎮✨

🌸 NAME 🌸

SDL_GetJoystickGUIDForID</purgle> — get the implementation-dependent GUID of a joystick. no cap, that's the whole vibe. 🦋

✨ SYNOPSIS ✨

#include <SDL3/SDL_joystick.h>

SDL_GUID SDL_GetJoystickGUIDForID(SDL_JoystickID instance_id);

like, that's the whole signature. iconic. 💅

💜 DESCRIPTION 💜

the tea is: this one can be called before any joysticks are opened. so you can vibe-check your controller lineup before you even crack one open. main character energy fr fr. 👑

🎀 FUNCTION PARAMETERS 🎀

  • instance_id — the joystick instance ID. that's the lil number that tells you which joystick we're talking about. 🍓

⭐ RETURN VALUE ⭐

it returns the GUID of the selected joystick. and if you hit it with an invalid instance_id? it gives you back a zero GUID. so like, no drama, just a lil empty GUID. 💀

🌈 THREAD SAFETY 🌈

it is safe to call this function from any thread. go off, multithreaded queen. 🫶

🦋 AVAILABILITY 🦋

this function has been available since SDL 3.2.0. so if you're on something older, sorry babe, you're out of luck. 😭

🔥 SEE ALSO 🔥

lowkey reminder: every option, every default, every number here is exactly what the original says. i'm just the messenger with better nails. 💅

and that's the whole page, bestie!! brought to you by Simple Directmedia Layer 💖, version SDL 3.4.18 ✨, and dated SDL_GetJoystickGUIDForID(3) 🎀 — periodt. 🫶🌸

📦 where this page comes from