Sun Microsystems Logo
Products and Services
 
Support and Training
 
 

A  B  C  D  E  F  G  H  I  J  K  L  M  N  O  P  Q  R  S  T  U  V  W  X  Y  Z  
 
Curses Library Functionsmenu_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(5) for descriptions of the following attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
MT-LevelUnsafe

SEE ALSO

 

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


NOTES

 

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



SunOS 5.9Go To TopLast Changed 31 Dec 1996


Updated: 2004-01-16, 17:36