Sortix volatile manual
This manual documents Sortix volatile, a development build that has not been officially released. You can instead view this document in the latest official manual.
MENU_NEW(3) | 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
(ITEM
**items);
DESCRIPTION
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 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 ALSO
NOTES
The header <menu.h> automatically includes both <curses.h> and <eti.h>.
Sepember 10, 1999 | Sortix 1.1.0-dev |