menu_item_new(3X)                 SDK R4.11                menu_item_new(3X)


NAME
       menu_item_new:  new_item, free_item - create and destroy menus items

SYNOPSIS
       #include <menu.h>

       ITEM *new_item(char *name, char *desc);
       int free_item(ITEM *item);

DESCRIPTION
       new_item creates a new item from name and description, and returns a
       pointer to the new item.

       free_item frees the storage allocated for item.  Once an item is
       freed, the user can no longer connect it to a menu.

RETURN VALUE
       new_item returns NULL on error.

       free_item 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_CONNECTED    - One or more items are already connected
                        to another menu.

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

SEE ALSO
       curses(3X), menus(3X).


Licensed material--property of copyright holder(s)