SDL_PRIs32(3)

💅 SDL_PRIs32 — the manual page, but make it cute

okay so bestie, you're reading the page for SDL_PRIs32 from the SDL3 FUNCTIONS manual, and honestly? it's a tiny one but it's an absolute icon. ✨

---

🌸 NAME 🌸

SDL_PRIs32 — a printf-formatting string for an Sint32 value. 🎀

That's it. That's the whole job. And it does it flawlessly.

---

✨ SYNOPSIS ✨

#include <SDL3/SDL_stdinc.h>

#define SDL_PRIs32 "d"

not me looking at a macro whose entire body is literally just "d" 💀 iconic behavior, no notes.

---

🦋 DESCRIPTION 🦋

So the vibe is: you want to print an Sint32 with printf-style formatting, and you want to do it portably, because hardcoding the wrong length modifier is how you get cursed output on some platform you've never even heard of. That's the whole reason this macro exists — it expands to the right string for your setup. 👑

Use it like this, fr fr:

SDL_Log("There are %" SDL_PRIs32 " bottles of beer on the wall.", bottles);

see what she did there? The format string is split around the macro. The % lives in the first literal, SDL_PRIs32 supplies the conversion specifier right after it, and then the rest of the string picks back up. It's giving string-literal sandwich 🥪 and it works because the preprocessor glues adjacent string literals together. Slay. 💅

no cap: the macro goes between the % and the rest of your text. Don't put the % inside it, don't wrap it in quotes, just let it sit there in the middle doing its little job. 🫶

---

🌈 AVAILABILITY 🌈

This macro is available since SDL 3.2.0. 🍓

So if you're on anything older, it's simply not there yet — check your version before you start yelling at the compiler. 😭

---

and that's the page!! 💖 This one came from the Simple Directmedia Layer crew, SDL 3.4.18 era, and it's filed under SDL_PRIs32(3). ily, go format some integers responsibly. 🎀🦋✨