Go to main content

man pages section 3: Curses Library Functions

Exit Print View

Updated: Thursday, June 13, 2019
 
 

menu_new(3CURSES)

Name

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

Attributes

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
MT-Level
Unsafe

See Also

curses(3CURSES), menus(3CURSES), attributes(7)

Notes

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