SDL_PRINTF_VARARG_FUNCV(3)

💖 SDL_PRINTF_VARARG_FUNCV 💖

okay bestie, this one is a macro from the SDL3 manual pages, and it's lowkey a little compiler-whisperer. it annotates a va_list function that does printf things. that's it, that's the whole vibe. 🎀

---

✨ NAME ✨

SDL_PRINTF_VARARG_FUNCV — a macro that annotates a va_list function that operates like printf. 💅

---

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_stdinc.h>

#define SDL_PRINTF_VARARG_FUNCV( fmtargnumber ) __attribute__(( format( __printf__, fmtargnumber, 0 )))

---

🦋 DESCRIPTION 🦋

so like, imagine we wanted to annotate vfprintf. it would go a little something like this:

int vfprintf(FILE *f, const char *fmt, va_list ap) SDL_PRINTF_VARARG_FUNCV(2);

what this is saying is: bestie, the second parameter is a printf-style format string, and right after it comes a va_list. 👑 and then the compiler — or whatever other analysis tools are watching — can pop off with a warning when that doesn't appear to be the case. vibe check failed, basically.

on compilers that don't have this annotation mechanism, this macro is defined to nothing. no drama, no annotation, just nothing. 💀

this can (and should) be used with SDL_PRINTF_FORMAT_STRING too — the two of them together cover at least Visual Studio, GCC, and Clang. between them, they ate. periodt. 🔥

---

🌈 AVAILABILITY 🌈

this macro is available since SDL 3.2.0. ✨

---

and that's the whole page, bestie 🫶 stay annotated, stay iconic, and may your format strings always match your args.

with love from the Simple Directmedia Layer girlies — this is SDL 3.4.18, manual page SDL_PRINTF_VARARG_FUNCV(3). mwah 💖