menu_item_new(3) - NetBSD Manual Pages

Command:
Section:
Arch:
Collection:
>>>
MENU_ITEM_NEW(3)        NetBSD Library Functions Manual       MENU_ITEM_NEW(3)


NAME

     free_item, new_item -- create or delete menu item


LIBRARY

     Curses Menu Library (libmenu, -lmenu)


SYNOPSIS

     #include <menu.h>

     int
     free_item(ITEM *item);

     ITEM *
     new_item(char *name, char *description);


DESCRIPTION

     The free_item() function destroys the item and frees all allocated stor-
     age for that item.  The new_item() allocates storage for a new item then
     copies in the item name and description for the new item.  A pointer to
     the newly created item is returned to the caller.


RETURN VALUES

     The new_item() function returns NULL on failure, the free_item() 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.


SEE ALSO

     curses(3), menus(3)


NOTES

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

NetBSD 5.0                    September 10, 1999                    NetBSD 5.0