SDL_ASSERT_FILE(3)

💅 SDL_ASSERT_FILE 💅

okay bestie, welcome to the SDL_ASSERT_FILE page, part of the SDL3 functions manual. she's a macro, she's tiny, she's lowkey iconic, and she's here to spill the tea on which file is currently getting compiled. 🎀

---

✨ NAME ✨

SDL_ASSERT_FILE — a macro that reports the current file being compiled, for use in assertions. that's it. that's the whole job. and she does it flawlessly. 👑

---

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_assert.h>

#define SDL_ASSERT_FILE SDL_FILE

---

🦋 DESCRIPTION 🦋

so here's the vibe: this macro is only defined if it isn't already defined. meaning if you, the main character, already rolled your own SDL_ASSERT_FILE before SDL got there, SDL is like "okay periodt, you got it, I'm not touching that." 🫶

and that's on purpose, because sometimes you want to override it — maybe with something that doesn't provide path information at all, so that your build machine's info doesn't leak into public binaries. not the build machine doxxing itself in your release build, no ma'am. 😭

to do that, apps can just define this macro before including SDL_assert.h. and like, a very clean example: defining it to "" will make sure no source path information is included in asserts. chef's kiss. ✨

---

🌈 AVAILABILITY 🌈

this macro is available since SDL 3.4.0. she's a newer girlie, be nice to her. 💖

---

fr fr, if you're overriding this to "" for privacy reasons, that's not you being paranoid, that's you being smart. slay. 💅

---

and that's the whole page bestie, no cap. brought to you by the lovely folks at Simple Directmedia Layer — this is the SDL 3.4.18 edition, documented under the SDL3 functions manual, and yes the header and footer of the original both say SDL_ASSERT_FILE(3) because she's the moment. 🎀✨🦋