menu_item_new(S-osr5)

menu_item_new: new_item, free_item -- create and destroy menus items

Syntax

cc ... -lmenu -lcurses

#include <menu.h>

ITEM *new_item(char *name, char *desc);
int free_item(ITEM *item);

Description

new_item- create a new menu item

free_item- free the space allocated to a new menu item

new_item(S-osr5) creates a new item from name and description, and returns a pointer to the new item.

free_item(S-osr5) 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_OK - The routine returned successfully.

E_SYSTEM_ERROR - System error.

E_BAD_ARGUMENT - An incorrect argument was passed to the routine.

E_CONNECTED - One or more items are already connected to another menu.

Warning

The header file menu.h automatically includes the header files eti.h and curses.h.

Files

/usr/lib/libmenu.a: the library

Standards conformance

new_item(S-osr5) and free_item(S-osr5) are not part of any currently supported standard; they were developed by UNIX System Laboratories, Inc. and are maintained by The SCO Group.

`E_OK`	-	The routine returned successfully.
`E_SYSTEM_ERROR`	-	System error.
`E_BAD_ARGUMENT`	-	An incorrect argument was passed to the routine.
`E_CONNECTED`	-	One or more items are already connected to another menu.