1menu_new(3CURSES)          Curses Library Functions          menu_new(3CURSES)
2
3
4

NAME

6       menu_new, new_menu, free_menu - create and destroy menus
7

SYNOPSIS

9       cc [ flag... ] file... -lmenu  -lcurses  [ library... ]
10       #include <menu.h>
11
12       MENU *new_menu(ITEM **items);
13
14
15       int free_menu(MENU *menu);
16
17

DESCRIPTION

19       new_menu() creates a new menu connected to the item pointer array items
20       and returns a pointer to the new menu.
21
22
23       free_menu() disconnects menu from its associated item pointer array and
24       frees the storage allocated for the menu.
25

RETURN VALUES

27       new_menu() returns NULL on error.
28
29
30       free_menu() returns one of the following:
31
32       E_OK               The routine returned successfully.
33
34
35       E_SYSTEM_ERROR     System error.
36
37
38       E_BAD_ARGUMENT     An incorrect argument was passed to the routine.
39
40
41       E_POSTED           The menu is already posted.
42
43

ATTRIBUTES

45       See attributes(5) for descriptions of the following attributes:
46
47
48
49
50       ┌─────────────────────────────┬─────────────────────────────┐
51       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
52       ├─────────────────────────────┼─────────────────────────────┤
53       │MT-Level                     │Unsafe                       │
54       └─────────────────────────────┴─────────────────────────────┘
55

SEE ALSO

57       curses(3CURSES), menus(3CURSES), attributes(5)
58

NOTES

60       The  header  <menu.h>  automatically  includes the headers  <eti.h> and
61       <curses.h>.
62
63
64
65SunOS 5.11                        31 Dec 1996                menu_new(3CURSES)