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);

MT-LEVEL

Unsafe

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 VALUES

new_item() returns NULL on error. 

free_item() returns one of the following:

E_OKThe routine returned successfully.
E_SYSTEM_ERRORSystem error.
E_BAD_ARGUMENTAn incorrect argument was passed to
the routine.
E_CONNECTEDOne or more items are already connected
to another menu.

SEE ALSO

curses(3X), menus(3X)

NOTES

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

SunOS 5.4  —  Last change: 22 Jan 1993