new(3MENU)

💖 new(3MENU) 💖

okay so bestie, welcome to the Library calls section, this is new(3MENU) and we're talking about menus — the make-one, break-one kind 🎀

---

✨ NAME ✨

new_menu, free_menu — create and destroy menus 🫶

---

🌸 SYNOPSIS 🌸

#include <menu.h>

MENU *new_menu(ITEM **items);
int free_menu(MENU *menu);

---

💅 DESCRIPTION 💅

so new_menu does exactly what it says on the tin, no cap — it creates a brand new menu and connects it to a specified item pointer array. and that array MUST be NULL-terminated, bestie, don't forget, the NULL is literally the vibe check at the end of the list 👑

and then free_menu? that's the breakup function 😭 it disconnects menu from its item array and frees all the storage that was allocated for the menu. clean exit, no loose ends, we love to see it ✨

---

🔥 RETURN VALUE 🔥

new_menu returns NULL on error. not great, not terrible, but it sets errno to tell you why it flopped:

• E_NOT_CONNECTED — no items are connected to the menu. it's giving empty roster 💀
• E_SYSTEM_ERROR — a system error occurred, e.g., malloc failure. the machine said no 🙈

and free_menu returns one of these lil guys:

• E_OK — the routine succeeded. ate and left no crumbs 💅
• E_SYSTEM_ERROR — system error occurred (see errno(3)). go check that man page, iykyk 🔍
• E_BAD_ARGUMENT — the routine detected an incorrect or out-of-range argument. someone handed it nonsense fr fr 😭
• E_POSTED — the menu has already been posted. bestie it's out there, you can't just free it while it's live 🚫

---

🌈 PORTABILITY 🌈

these routines emulate the System V menu library. they were not supported on Version 7 or BSD versions — so if you're on ancient territory, that's a no from them 🧚

---

👑 AUTHORS 👑

Juergen Pfeifer. Manual pages and adaptation for new curses by Eric S. Raymond. absolute icons, we stan ⭐

---

🦋 SEE ALSO 🦋

• ncurses(3NCURSES)
• menu(3MENU)

---

and that's the whole page, bestie!! this lil manual came to you from ncurses 6.6, dated 2024-12-28 — signed, sealed, and slaying 💖✨🎀