menu_new(3ocurses)

menu_new: new_menu, free_menu -- create and destroy menus

Synopsis

cc [flag . . .] file -lmenu -locurses [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.

Notices

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

References

curses(3ocurses), menus(3ocurses)

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.