SDL_GETGAMEPADSTRINGFORBUTTON(3)

💖 SDL_GetGamepadStringForButton(3) 💖

okay bestie, welcome to the SDL3 FUNCTIONS section of the manual, and today we're doing the cutest little enum-to-string glow-up you've ever seen ✨

---

🌸 NAME 🌸

SDL_GetGamepadStringForButton — the way that you take an SDL_GamepadButton enum and turn it into a string. literally just enum → string, no cap 💅

---

🎀 SYNOPSIS 🎀

#include <SDL3/SDL_gamepad.h>

const char * SDL_GetGamepadStringForButton(SDL_GamepadButton button);

---

✨ FUNCTION PARAMETERS ✨

• button — an enum value for a given SDL_GamepadButton. that's it, that's the whole input, she's lowkey simple like that 🦋

---

💫 RETURN VALUE 💫

you get back a string for the button you asked about 🫶 — but if you hand her an invalid button, she returns NULL, so check that before you go using it, fr fr 😭

and the string she gives you? it's in the format used by SDL_Gamepad mapping strings. so it's not just any string, it's that string, iykyk 👑

---

🧵 THREAD SAFETY 🧵

it is safe to call this function from any thread. any of them. all of them. go wild, bestie 🌈✨

---

🗓️ AVAILABILITY 🗓️

this function is available since SDL 3.2.0. so if you're on something older, no she is not there, sorry 🥲

---

👀 SEE ALSO 👀

• SDL_GetGamepadButtonFromString(3) — the reverse girly, go check her out 💜

---

not me making an entire manual page about one function and being obsessed with her 💀 she's iconic, she's efficient, she ate and left no crumbs 🍓

---

Simple Directmedia Layer · SDL 3.4.18 — mwah, love u, go read the other pages, this diva of a manual was served to you fresh 💖🎀🦋💅