NAME    [Toc]    [Back]

     free_menu, new_menu - create or delete a menu

LIBRARY    [Toc]    [Back]

     Curses Menu Library (libmenu, -lmenu)

SYNOPSIS    [Toc]    [Back]

     #include <menu.h>

     int
     free_menu(MENU *menu);

     MENU *
     new_menu(ITEMS **items);

DESCRIPTION    [Toc]    [Back]

     The free_menu() menu function destroys the given menu and frees all allocated
 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 initialises 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    [Toc]    [Back]

     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 ALSO    [Toc]    [Back]

     curses(3), menus(3)

NOTES    [Toc]    [Back]

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

BSD                           September 10, 1999                           BSD