SDL_GetGamep...NameForButton(3)

💖 SDL_GetGamepadAppleSFSymbolsNameForButton 💖

okay bestie, so this one lives in the SDL3 FUNCTIONS corner of the SDL3 manual, and it's literally the glow-up you need if you're on Apple platforms and you want your gamepad buttons to have those cute little SF Symbols names. 🎀

✨ NAME ✨

SDL_GetGamepadAppleSFSymbolsNameForButton — return the sfSymbolsName for a given button on a gamepad, but only on Apple platforms, bestie. 🍎✨

---

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_gamepad.h>

const char * SDL_GetGamepadAppleSFSymbolsNameForButton(SDL_Gamepad *gamepad, SDL_GamepadButton button);

like, that's the whole vibe. two args in, a string out. no cap. 💅

---

🦋 FUNCTION PARAMETERS 🦋

• gamepad — the gamepad you're querying, bestie. the one you want the tea about. 🎮
• button — a button on that gamepad. yes, an actual button, we're not doing vibes-only here. 🔘

---

⭐ RETURN VALUE ⭐

It returns the sfSymbolsName, or NULL if the name can't be found. 😭

fr fr, NULL is a real possible answer here — it's not a "this never happens" situation. always check, bestie. 🫶

---

🧚 THREAD SAFETY 🧚

It is safe to call this function from any thread. go off, queen, spawn all the threads you want. 🔥

---

🌈 AVAILABILITY 🌈

This function is available since SDL 3.2.0. so if you're on anything older, it's giving "not yet, babe". 💀

---

👑 SEE ALSO 👑

• SDL_GetGamepadAppleSFSymbolsNameForAxis(3) — the axis-flavored sibling, go read it too, iykyk. 🕹️

---

and that's the whole page, periodt. 💜 this lil icon of a manpage is brought to you by Simple Directmedia Layer, version SDL 3.4.18 — mwah, love that for us. 🎀✨🦋