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


NAME
       menuitemnew:  newitem, freeitem - create and destroy menus items

SYNOPSIS
       #include <menu.h>

       ITEM *newitem(char *name, char *desc);
       int freeitem(ITEM *item);

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

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

RETURN VALUE
       newitem returns NULL on error.

       freeitem returns one of the following:
       EOK           - The routine returned successfully.
       ESYSTEMERROR - System error.
       EBADARGUMENT - An incorrect argument was passed to the routine.
       ECONNECTED    - 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)