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>.

December 31, 1996 MENU_NEW(3CURSES)