SDL_GetJoystickProduct(3)

✨ SDL_GetJoystickProduct ✨

okay bestie, welcome to the SDL3 FUNCTIONS corner of the manual, this one's a lil bop called SDL_GetJoystickProduct and it is exactly as unhinged-simple as it sounds 💖

---

🌸 NAME 🌸

SDL_GetJoystickProduct — get the USB product ID of an opened joystick, if available. that "if available" is doing a LOT of heavy lifting btw, we'll get there 🫶

---

🎀 SYNOPSIS 🎀

#include <SDL3/SDL_joystick.h>

Uint16 SDL_GetJoystickProduct(SDL_Joystick *joystick);

like. one include, one function, one Uint16 coming back at ya. iconic behavior honestly ✨

---

💅 DESCRIPTION 💅

so here's the tea, bestie: you hand it a joystick, it gives you back the USB product ID. that's it. that's the whole vibe 🦋

BUT — and this is the part where I need you to lock in — if the product ID isn't available this function returns 0. so if you get a 0 back, don't be out here thinking "omg the product ID is literally zero", no ma'am. that's the "idk bestie" answer. it's giving unavailable, not zero 💀

---

🍓 FUNCTION PARAMETERS 🍓

• joystick — the SDL_Joystick you got from SDL_OpenJoystick(). that's the one, the only, the main character 👑

---

⭐ RETURN VALUE ⭐

returns the USB product ID of the selected joystick, or 0 if it's unavailable. periodt. that's the whole return value. no secret third thing 🌈

---

🔥 THREAD SAFETY 🔥

it is safe to call this function from any thread. yes, ANY. go wild, no cap, thread it up 🧚

---

👑 AVAILABILITY 👑

this function has been available since SDL 3.2.0. so if you're on something older... my condolences, bestie, upgrade 💜

---

🦋 SEE ALSO 🦋

• SDL_GetJoystickProductForID(3) — the sibling, the sister function, the iykyk one 🎀

---

and that's the whole page!! written up by Simple Directmedia Layer, running on SDL 3.4.18 — mwah, slay, go read your joystick's product ID, I'm obsessed with you 💖✨🌸