al_remove_menu_item(3)

🎀 NAME 🎀

okay so this page is al_remove_menu_item(3), straight out of the Library Functions Manual, and it's all about the Allegro 5 API bestie 💅

al_remove_menu_item — removes one item from a menu and destroys it. gone, bye, no cap ✨

---

🌸 SYNOPSIS 🌸

#include <allegro5/allegro_native_dialog.h>

bool al_remove_menu_item(ALLEGRO_MENU *menu, int pos)

---

💖 DESCRIPTION 💖

So like, al_remove_menu_item removes the specified item from the menu and destroys it — not just unlinks it, not just hides it, destroys it 🔥

And if that item contains a sub-menu? bestie, the sub-menu gets destroyed too 😭 the whole little family tree is coming down with it. Any references to it are invalidated. do not touch them after this, fr fr 🙈

If you actually want to preserve that sub-menu, you have to make a copy first with al_clone_menu(3) — that's the move, okay? 🫶

⚠️ important vibe check: removing an item destroys it and any sub-menu inside it, and any references to it become invalidated. if you need the sub-menu later, clone it before you remove anything 💀

This is safe to call on a menu that is currently being displayed — yes, even while it's literally on screen, she's fine with that 👑

Returns true if an item was removed 🌟

---

⭐ SINCE ⭐

5.1.0 — iconic behavior since 5.1.0, periodt 💜

---

🦋 SEE ALSO 🦋

• al_append_menu_item(3) — when you wanna add an item instead
• al_insert_menu_item(3) — when you wanna slide one in at a specific spot
• al_destroy_menu(3) — when the whole menu needs to go 👋

---

xoxo, source: Allegro reference manual 💖 — and the date? this copy didn't give me one, so that's all I have, bestie 🫶✨