update_menu(3)

📦 version 4.4.3.1, in fedora 43, fedora 44

💖 update_menu(3) 💖

ok so bestie, welcome to the Allegro manual — yes, the Allegro game programming library, the whole reason we're here. This page is all about update_menu, a low level function to update a menu player. Low level means it's giving backstage-pass energy, not front-row-seat energy, but trust, it's important. 🎀

✨ NAME ✨

update_menu — the low level function that updates a menu player. Part of the Allegro game programming library. 💅

🌸 SYNOPSIS 🌸

#include <allegro.h>

int update_menu(MENU_PLAYER *player);

🦋 DESCRIPTION 🦋

So here's the tea, bestie: update_menu() updates the status of a menu object — and that menu object is one that came back to you from init_menu(). You don't just summon it out of thin air, okay? It's a whole relationship. 🫶

It returns TRUE if the menu is still active (she's alive, she's thriving, keep going), or FALSE if it has terminated (she's done, she said goodbye, she logged off). 💀

And here's the part you actually need to pay attention to: if it hands you back FALSE, then it's up to you to call shutdown_menu() — or to just continue execution. Your call, your main character moment, but the function is NOT doing it for you. No cap. 🙈

fr fr, that FALSE return is your cue to act. Nobody's coming to clean up for you. 😭

👑 SEE ALSO 👑

and that's the whole page, periodt. This little icon was brought to you by Allegro, version 4.4.3 — mwah, love her, thanks for everything. Now go call shutdown_menu() when she tells you to. ✨🦋💖

📦 where this page comes from