al_find_menu_item(3)

💅 al_find_menu_item(3) — Allegro 5 API 🎀

okay bestie, this one lives in the Library Functions Manual and it's lowkey one of the most useful little gremlins in the whole native dialog family. it's called al_find_menu_item and it's from the Allegro 5 API, which you already knew because you're a main character who reads headers 💖

---

✨ SYNOPSIS ✨

like, here's the whole vibe:

#include <allegro5/allegro_native_dialog.h>

bool al_find_menu_item(ALLEGRO_MENU *haystack, uint16_t id, ALLEGRO_MENU **menu,
   int *index)

no cap, that's literally it. she's compact. she's efficient. she ate. 👑

---

🌸 DESCRIPTION 🌸

so the way this works is, al_find_menu_item searches through the haystack menu looking for an item with the given id. it's giving needle-in-a-haystack but make it a menu 🧚✨ (yes the parameter is genuinely named haystack, iconic naming honestly)

heads up bestie 🚨 that id is a literal ID and it cannot be used as an index. like, do NOT try to be cute and pass an index in there, it will not slay. iykyk.

if menu and index are not NULL, they get set to the parent menu containing the item, and the zero-based (positive) index of the item respectively. so you get where it lives and where it sits. 🫶

⚠️ caveat time ⚠️ if the menu item was not found, then the values of menu and index are undefined. literally undefined. as in, don't go reading them and acting surprised. 🙈

and the return value? she returns true if the menu item was found. that's it. that's the whole vibe check. ⭐

---

🦋 SINCE 🦋

5.1.0 — she's been around. an elder. a legend. 💜

---

💅 SEE ALSO 💅

• al_find_menu(3) — the sibling, the costar, the other half of the duo 🎀

---

okay that's the whole page!! go forth and find your menu items, bestie 🌈💖

— with love, from the Allegro reference manual 🎀 (yes that's the source and that's the version-of-record, no calendar date on this one, so just vibe with it) ✨