menu_new(3X)

💅 menu_new(3X) 💅

okay so you're in the Library calls aisle of the manual, bestie, and this page is all about new_menu and free_menu — the create-and-destroy duo for menus. periodt. ✨

---

🌸 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 creates a fresh new menu connected to a specified item pointer array — and bestie, that array must be NULL-terminated. no cap, that part matters. 💖

🚨 vibe check: the item pointer array has to be NULL-terminated, fr fr.

Then free_menu disconnects menu from its item array and frees the storage that was allocated for the menu. it's giving cleanup era. 🧹✨

---

💅 RETURN VALUE 💅

new_menu returns NULL on error. it sets errno according to the function's failure, like this:

• E_NOT_CONNECTED — no items are connected to the menu. 😭
• E_SYSTEM_ERROR — system error occurred, e.g., malloc failure. 💀

The function free_menu returns one of these:

• E_OK — the routine succeeded. slay. 👑
• E_SYSTEM_ERROR — system error occurred (see errno(3)). 🫠
• E_BAD_ARGUMENT — routine detected an incorrect or out-of-range argument. 🚩
• E_POSTED — the menu has already been posted. 🙈

---

🌈 PORTABILITY 🌈

These routines emulate the System V menu library. They were not supported on Version 7 or BSD versions. iykyk. 🧚

---

💜 AUTHORS 💜

Juergen Pfeifer. Manual pages and adaptation for new curses by Eric S. Raymond. iconic work, honestly. 🫶

---

⭐ SEE ALSO ⭐

• curses(3X)
• menu(3X)

---

💖 that's the whole page, bestie — brought to you by ncurses 6.5, dated 2024-12-28, and signed menu_new(3X) ✨