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 11.0