mitem_opts(3X)

📦
version 6.6_p20260516 · 6 versions
, in alpine 3.24, arch rolling, fedora 44

💖 mitem_opts — the manual page, but make it cute 💖

okay bestie, welcome to mitem_opts(3X) from the library calls girlies ✨ this one is all about menu item options — setting them, getting them, turning them on, turning them off. lowkey iconic behaviour tbh.

🌸 NAME 🌸

set_item_opts, item_opts_on, item_opts_off, item_opts — set and get menu item options 🎀

✨ SYNOPSIS ✨

#include <menu.h>

int set_item_opts(ITEM *item, Item_Options opts);
Item_Options item_opts(const ITEM *item);

int item_opts_on(ITEM *item, Item_Options opts);
int item_opts_off(ITEM *item, Item_Options opts);

like, four functions, one header, zero drama 💅

🦋 DESCRIPTION 🦋

so. here's the tea ☕

  • set_item_opts — this one sets all the given item's option bits. and yes, menu option bits may be logically "or"-ed together, so you can stack 'em. it's giving toggles, but make it official.
  • item_opts_on — turns on the given option bits, and leaves all the others alone. it's not nosy, it minds its business 🫶
  • item_opts_off — turns off the given option bits, and leaves all the others alone. same energy, opposite direction.
  • item_opts — just returns the item's current option bits. no notes, no changes, pure information ✨

now for the main character of this whole page: there is only one defined option bit mask, and it's O_SELECTABLE 👑

when O_SELECTABLE is on, the item may be selected during menu processing. and here's the thing — this option defaults to on. so bestie, it's already slaying unless you personally go turn it off 💀

💜 RETURN VALUE 💜

except for item_opts, each routine returns one of the following:

  • E_OK — the routine succeeded. ate, no crumbs 🔥
  • E_SYSTEM_ERROR — system error occurred (see errno(3)). not the vibe, go check your errno 😭
fyi item_opts doesn't play this game — it hands you back the option bits themselves instead of a status code. don't @ me, that's just how it is.

🌈 PORTABILITY 🌈

these routines emulate the System V menu library. they were not supported on Version 7 or BSD versions. so like, respect the heritage, iykyk 💫

👑 AUTHORS 👑

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

🎀 SEE ALSO 🎀

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

and that's the whole page, bestie 🍓 this was ncurses 6.6, dated 2025-01-18, and it lives at mitem_opts(3X). go forth and set your options with main character energy 💅✨

📦 where this page comes from