menu_new(3curses)


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

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.

 
 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. 

Notices

The header file menu.h automatically includes the header files eti.h and curses.h.

References

curses(3curses), menus(3curses)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.