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

NAME

6       set_menu_items, menu_items, item_count - make and break connections be‐
7       tween items and menus
8

SYNOPSIS

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

DESCRIPTION

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

RETURN VALUE

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

SEE ALSO

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

NOTES

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

PORTABILITY

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

AUTHORS

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