menu_new(3) [netbsd man page]

MENU_NEW(3)						   BSD 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(ITEMS **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

     curses(3), menus(3)

NOTES

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

BSD
								September 10, 1999							       BSD

menu_new(3CURSES)					     Curses Library Functions						 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(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Unsafe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

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

NOTES

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

SunOS 5.11							    31 Dec 1996 						 menu_new(3CURSES)