MENU_NEW(3) BSD Library Functions Manual MENU_NEW(3)NAME
free_menu, new_menu — create or delete a menu
LIBRARY
Curses Menu Library (libmenu, -lmenu)
SYNOPSIS
#include <menu.h>
int
free_menu(MENU *menu);
MENU *
new_menu(ITEMS **items);
DESCRIPTION
The free_menu() menu function destroys the given menu and frees all allo‐
cated storage associated with the menu. All items associated with the
menu are detached from the menu before it is destroyed. The new_menu()
function allocates storage for a new menu and initializes all the values
to the defined defaults. If the items pointer passed is not a NULL then
the given NULL terminated array of items is attached to the new menu.
RETURN VALUES
The new_menu() function returns NULL on error, while the free_menu()
function returns one of the following error values:
E_OK The function was successful.
E_BAD_ARGUMENT One or more of the arguments passed to the function was
incorrect.
E_POSTED The menu is already posted.
SEE ALSOcurses(3), menus(3)NOTES
The header <menu.h> automatically includes both <curses.h> and <eti.h>.
BSD September 10, 1999 BSD