items(3MENU)

💖 items(3MENU) — library calls, but make it a vibe ✨

okay bestie, so we're in items(3MENU) territory, which is the part of the library where you make and break connections between items and menus 🎀 it's giving matchmaker energy fr fr, and honestly? we're obsessed.

---

🌸 NAME 🌸

set_menu_items, menu_items, item_count — these three are literally the glue that makes and breaks connections between items and menus. periodt. 💅

---

✨ SYNOPSIS ✨

#include <menu.h>

int set_menu_items(MENU *menu, ITEM **items);
ITEM **menu_items(const MENU *menu);
int item_count(const MENU *menu);

yes, that's it, that's the whole lil squad 🫶

---

🦋 DESCRIPTION 🦋

So like, three functions, three jobs, all iconic in their own way:

• set_menu_items — this one changes the item pointer array of the given menu. and listen, the array must be terminated by a NULL. no cap. if you forget the NULL bestie, that's a whole situation you do not want 💀
• menu_items — this one just hands you back the item array of the given menu. lowkey the chill one of the group 🌈
• item_count — and this one returns the count of items in menu. the math girlie of the trio, we stan 🍓

---

🔥 RETURN VALUE 🔥

• menu_items returns a pointer — which may be NULL, so pls check it 🙈 — and it does not set errno.
• item_count returns ERR (aka the general curses error return value) if its menu parameter is NULL. so yeah, pass a real menu, not vibes ✨
• set_menu_items returns one of the following codes when something goes sideways:
• E_OK — the routine succeeded. slay, we love to see it 👑
• E_BAD_ARGUMENT — routine detected an incorrect or out-of-range argument. not the argument being messy 😭
• E_NOT_CONNECTED — no items are connected to the menu. it's giving ghosted 💀
• E_POSTED — the menu is already posted. can't do the thing while it's out there living its main character moment, sorry 🎀
• E_SYSTEM_ERROR — system error occurred (see errno(3)). the computer said no 🌧️

---

💜 PORTABILITY 💜

These routines emulate the System V menu library. they were not supported on Version 7 or BSD versions, so if you're kicking it old-school with those, bestie, you're on your own 🧚

Also important, highkey: the SVr4 menu library documentation specifies the item_count error value as -1 (which is the value of ERR). so like, same energy, different spelling 💅

---

🌟 AUTHORS 🌟

Juergen Pfeifer. Manual pages and adaptation for new curses by Eric S. Raymond. absolute legends, ty for your service 🫶

---

🌈 SEE ALSO 🌈

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

go read those next bestie, it's a whole journey ✨

---

okay and that's the whole page!! 💖 this was ncurses 6.6, dated 2024-12-28, and it's the items(3MENU) girlies signing off — stay connected, terminate your arrays with NULL, and don't be a E_POSTED situation 🎀💅✨