menu_new(S-osr5)

menu_new: new_menu, free_menu -- create and destroy menus

Syntax

cc ... -lmenu -lcurses

#include <menu.h>

MENU *new_menu(ITEM **items);
int free_menu(MENU *menu);

Description

new_menu- create a menu connected to an item pointer array

free_menu- disconnect a menu from its item pointer array and free the menu's storage space

new_menu(S-osr5) creates a new menu connected to the item pointer array items and returns a pointer to the new menu.

free_menu(S-osr5) 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.

Warning

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

Files

/usr/lib/libmenu.a: the library

Standards conformance

new_menu(S-osr5), and free_menu(S-osr5) are not part of any currently supported standard; they were developed by UNIX System Laboratories, Inc. and are maintained by The SCO Group.

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