menu_post(3X)

💅 menu_post — bestie, it's giving "put the menu on the screen"

ok so this page is from menu_post(3X), filed under Library calls, and it's all about post_menu and unpost_menu — the two functions that literally make your menu show up or go away. slay. ✨

---

🎀 SYNOPSIS 🎀

#include <menu.h>

int post_menu(MENU *menu);
int unpost_menu(MENU *menu);

two functions, one header, zero drama. 🫶

---

🌸 DESCRIPTION 🌸

💖 post_menu

post_menu displays a menu to its associated subwindow. that's it, that's the vibe.

⭐ important bestie note: posting the menu doesn't automatically paint the subwindow on the physical screen. to trigger physical display of the subwindow you gotta use refresh(3X) or some equivalent curses routine — and yes, the implicit doupdate triggered by a curses input request will do the job too. iykyk.

also, post_menu resets the selection status of all items. every single one. fresh start, main character energy. 🔥

🦋 unpost_menu

unpost_menu erases menu from its associated subwindow. bye bye, menu. 🎀

---

✨ RETURN VALUE ✨

these routines return one of the following, and you WILL check them, ok?

• E_OK — the routine succeeded. ate. 👑
• E_SYSTEM_ERROR — system error occurred (see errno(3)). 💀
• E_BAD_ARGUMENT — routine detected an incorrect or out-of-range argument. the audacity.
• E_POSTED — the menu has already been posted. it's already up there, bestie, chill.
• E_BAD_STATE — routine was called from an initialization or termination function. wrong place, wrong time 😭
• E_NO_ROOM — menu is too large for its window. you should consider using set_menu_format to solve the problem. it's giving "doesn't fit" 🙈
• E_NOT_POSTED — the menu has not been posted. nothing to unpost, nothing to see.
• E_NOT_CONNECTED — no items are connected to the menu. an empty menu is not the serve you think it is.

---

🌈 PORTABILITY 🌈

these routines emulate the System V menu library. they were not supported on Version 7 or BSD versions — so don't come for them if you're on ancient territory, ngl.

---

👑 AUTHORS 👑

Juergen Pfeifer. Manual pages and adaptation for new curses by Eric S. Raymond. legends, fr fr. 🫶

---

🍓 SEE ALSO 🍓

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

---

mwah 💋 that's the whole page — this was ncurses 6.5, dated 2024-03-16, and menu_post(3X) is officially done. go post your menu, bestie. 💅✨