allegro_exit(3alleg4)

✨ allegro_exit ✨

okay bestie, so allegro_exit is the page in the Allegro manual that tells you how to say bye-bye to the whole Allegro system 💅 it's like the goodbye hug at the end of the party, except the party is your graphics library.

🌸 NAME 🌸

allegro_exit — closes down the Allegro system, fr fr 🫶

🎀 SYNOPSIS 🎀

#include <allegro.h>

void allegro_exit();

🦋 DESCRIPTION 🦋

So what does it do? It closes down the Allegro system. That means:

• it returns the system to text mode 📺
• it removes whatever mouse, keyboard, and timer routines have been installed 👋

and here's the slay part: you don't normally need to bother making an explicit call to this function, because allegro_init() installs it as an atexit() routine, so it just gets called automatically when your program exits. no cap. it handles itself. main character energy honestly 👑

💀 but wait, the warning. After you call this function, other functions like destroy_bitmap() will most likely crash. and that is a problem for C++ global destructors, because those usually get called after atexit(), so don't put Allegro calls in them. 😭

the fix tho? you can write the destructor code in another method, and manually call that method before your program exits — that avoids the whole problem entirely. iconic workaround, honestly. ✨

💖 SEE ALSO 💖

• install_allegro(3alleg4)
• allegro_init(3alleg4)
• destroy_bitmap(3alleg4)
• ex3d(3alleg4)
• exscn3d(3alleg4)
• exswitch(3alleg4)
• exxfade(3alleg4)
• exzbuf(3alleg4)

mwah 💋 that was the Allegro manual, version 4.4.3 — go forth and exit cleanly, bestie, and don't you dare put Allegro calls in a global destructor 🎀✨🦋