MENU_ITEMS(3)

MENU_ITEMS(3) | Library Functions Manual | MENU_ITEMS(3)

# NAME

item_count, menu_items, set_menu_items — attach items to menus or check correspondences

# LIBRARY

Curses Menu Library (libmenu, -lmenu)

# SYNOPSIS

#include <menu.h>

int
item_count(MENU *menu);

ITEM **
menu_items(MENU *menu);

int
set_menu_items(MENU *menu, ITEM **items);

# DESCRIPTION

The item_count() menu function returns the number of items currently attached to the menu passed. The menu_items() function returns a pointer to an array of item pointers that represent the menu items currently attached to the given menu. Apart from using new_menu() (see menu_new(3)) menu items may be attached to a menu by calling set_menu_items() any items currently attached to the menu will be detached and the NULL terminated array of new items will be attached to the menu.

# RETURN VALUES

Any function returning a string pointer will return NULL if an error occurs. Functions returning an integer will return one of the following:

E_OK
  The function was successful.
E_POSTED
  The menu is already posted.
E_CONNECTED
  An item was already connected to a menu.

# SEE ALSO

curses(3), menus(3)

# NOTES

The header <menu.h> automatically includes both <curses.h> and <eti.h>.

September 10, 1999 | NetBSD 7.1