September 10, 1999 MENU_ITEM_NEW 3

### NAME

free_item, new_item - create or delete menu item

### LIBRARY

Curses Menu Library (libmenu, -lmenu)

### SYNOPSIS

```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.

### SEE ALSO

curses(3), menus(3)

### NOTES

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