1menu_items(3X)                                                  menu_items(3X)
2
3
4

NAME

6       set_menu_items,  menu_items,  item_count  -  make and break connections
7       between items and menus
8

SYNOPSIS

10       #include <menu.h>
11       int set_menu_items(MENU *menu, ITEM **items);
12       ITEM **menu_items(const MENU *menu);
13       int item_count(const MENU *menu);
14

DESCRIPTION

16       The function set_menu_items changes the item pointer array of the given
17       menu.  The array must be terminated by a NULL.
18
19       The function menu_items returns the item array of the given menu.
20
21       The function item_count returns the count of items in menu.
22

RETURN VALUE

24       The function menu_items returns a pointer (which may be NULL).  It does
25       not set errno.
26
27       The function item_count returns ERR (the general  curses  error  return
28       value) if its menu parameter is NULL.
29
30       The  function  set_menu_items  returns  one  of  the following codes on
31       error:
32
33       E_OK The routine succeeded.
34
35       E_BAD_ARGUMENT
36            Routine detected an incorrect or out-of-range argument.
37
38       E_NOT_CONNECTED
39            No items are connected to the menu.
40
41       E_POSTED
42            The menu is already posted.
43
44       E_SYSTEM_ERROR
45            System error occurred (see errno).
46

SEE ALSO

48       curses(3X), menu(3X).
49

NOTES

51       The  header  file  <menu.h>  automatically  includes  the  header  file
52       <curses.h>.
53

PORTABILITY

55       These  routines  emulate the System V menu library.  They were not sup‐
56       ported on Version 7 or BSD versions.
57
58       The SVr4 menu library  documentation  specifies  the  item_count  error
59       value as -1 (which is the value of ERR).
60

AUTHORS

62       Juergen Pfeifer.  Manual pages and adaptation for new curses by Eric S.
63       Raymond.
64
65
66
67                                                                menu_items(3X)