SDL_itoa(3)

💅 SDL_itoa — bestie edition ✨

okay so this is SDL_itoa(3), a lil function from the SDL3 FUNCTIONS crew, and it's literally here to turn your integers into cute lil strings 🎀

---

✨ NAME ✨

SDL_itoa — Convert an integer into a string. that's it, that's the whole job, and she does it flawlessly 💖

---

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_stdinc.h>

char * SDL_itoa(int value, char *str, int radix);

---

🦋 DESCRIPTION 🦋

so the vibe here is that you gotta tell her what radix you want for the string format, no guessing, she's not a mind reader bestie 😭

• radix 10 → you get a decimal number
• radix 16 → you get hexadecimal
• etc etc, you get the picture

and the radix must be in the range of 2 to 36. no cap. outside that range is not the move 🙈

⚠️ NOT ME FORGETTING TO WARN YOU: this function will overflow a buffer if str is not large enough to hold the output! it's giving chaos, it's giving undefined, it's giving 💀

so if you want to be a responsible main character, it may be safer to use SDL_snprintf to clamp output, or SDL_asprintf to allocate a buffer 🫶

otherwise, honestly? it doesn't hurt to allocate much more space than you expect to use. and don't forget possible negative signs, null terminator bytes, etc etc etc. the little guys add up, fr fr 🌸

---

🎀 FUNCTION PARAMETERS 🎀

• value — the integer to convert. the star of the show, the moment, the icon 👑
• str — the buffer to write the string into. she's the vessel, she's the canvas, she's gotta be big enough 💅
• radix — the radix to use for string generation. between 2 and 36, remember? ⭐

---

💖 RETURN VALUE 💖

Returns str. yeah, she just hands you back the same buffer you gave her. iconic behavior, no notes 💜

---

🌈 THREAD SAFETY 🌈

It is safe to call this function from any thread. multitasking queen, we love to see it 🧚

---

⭐ AVAILABILITY ⭐

This function is available since SDL 3.2.0. so if you're on something older... not me, not you, we don't know her 🙈

---

👑 SEE ALSO 👑

• SDL_uitoa(3)
• SDL_ltoa(3)
• SDL_lltoa(3)

go read the whole fam, they're all serving ✨

---

k that's the whole page bestie, go forth and convert your ints responsibly 💖

this lil masterpiece came from the Simple Directmedia Layer girlies, running SDL 3.4.18, and yes she's literally SDL_itoa(3) — mwah, bye 🎀💅✨