SDL_EnterAppMainCallbacks(3)

💖 SDL_EnterAppMainCallbacks(3) 💖

okay bestie, welcome to the SDL3 FUNCTIONS corner of the man pages, this one's called SDL_EnterAppMainCallbacks and it's lowkey a secret backstage door. let's get into it 🎀

---

✨ NAME ✨

SDL_EnterAppMainCallbacks — the entry point that SDL uses when you're rolling with SDL_MAIN_USE_CALLBACKS. it's giving "backstage pass" energy 🫶

---

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_main.h>

int SDL_EnterAppMainCallbacks(int argc, char *argv[], SDL_AppInit_func appinit, SDL_AppIterate_func appiter, SDL_AppEvent_func appevent, SDL_AppQuit_func appquit);

look at all those callback params, it's literally a whole friend group 🧚

---

💅 DESCRIPTION 💅

okay so generally you should NOT call this function directly. like, fr fr. this thing only exists so SDL can hand off work into itself ASAP — that way SDL has so much more control and functionality available to it, and the inline code in SDL_main.h stays as smol and cute as possible ✨

and btw, not every platform even uses this. its actual use is hidden inside a magic header-only library 🪄 (yes, magic, we said what we said). so you should not call this directly unless you _really_ know what you're doing. emphasis on really, bestie, we're being so serious 😭

💀 calling this when you don't 100% know what you're doing is not the vibe. it's not a "just try it and see" situation. iykyk.

---

🦋 FUNCTION PARAMETERS 🦋

• argc — standard Unix main argc. the classic. the icon. the number-of-args situation 👑
• argv — standard Unix main argv. the actual args themselves, slaying in array form 💜
• appinit — the application's SDL_AppInit function. your little init moment 🌱
• appiter — the application's SDL_AppIterate function. the loop girlie, doing her rounds on repeat 🔁
• appevent — the application's SDL_AppEvent function. catching every event like it's gossip 🍓
• appquit — the application's SDL_AppQuit function. the graceful goodbye, no dramatic exits 🌈

---

⭐ RETURN VALUE ⭐

returns the standard Unix main return value. nothing fancy, just the classic int, doing its thing 💖

---

🎀 THREAD SAFETY 🎀

🚨 it is not safe to call this anywhere except as the only function call in SDL_main. only. one. call. no friends allowed. periodt.

---

🌟 AVAILABILITY 🌟

this function is available since SDL 3.2.0 ✨ (so if you're on an older SDL, she's not there yet, be patient bestie 🦋)

---

and that's the whole page!! mwah 💋 this came to you from the fine people at Simple Directmedia Layer, SDL 3.4.18, and yeah it's SDL_EnterAppMainCallbacks(3) — go forth and do NOT call it directly unless you're built different 💅💖