MENU_NEW(3CURSES) Curses Library Functions MENU_NEW(3CURSES)

NAME


menu_new, new_menu, free_menu - create and destroy menus

SYNOPSIS


cc [ flag... ] file... -lmenu -lcurses [ library... ]
#include <menu.h>

MENU *new_menu(ITEM **items);


int free_menu(MENU *menu);


DESCRIPTION


new_menu() creates a new menu connected to the item pointer array items
and returns a pointer to the new menu.


free_menu() disconnects menu from its associated item pointer array and
frees the storage allocated for the menu.

RETURN VALUES


new_menu() returns NULL on error.


free_menu() returns one of the following:

E_OK
The routine returned successfully.


E_SYSTEM_ERROR
System error.


E_BAD_ARGUMENT
An incorrect argument was passed to the routine.


E_POSTED
The menu is already posted.


ATTRIBUTES


See attributes(7) for descriptions of the following attributes:


+---------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------+
|MT-Level | Unsafe |
+---------------+-----------------+

SEE ALSO


curses(3CURSES), menus(3CURSES), attributes(7)

NOTES


The header <menu.h> automatically includes the headers <eti.h> and
<curses.h>.

illumos December 31, 1996 MENU_NEW(3CURSES)