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

NAME

6       menu_items - make and break connections between items and menus
7

SYNOPSIS

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

DESCRIPTION

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

RETURN VALUE

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

SEE ALSO

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

NOTES

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

PORTABILITY

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

AUTHORS

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