MENU_ITEM_NEW(3) |
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 storage 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.
NOTES
The header <menu.h> automatically includes both <curses.h> and <eti.h>.