DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH
 

menu_item_new(S)


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) creates a new item from name and description, and returns a pointer to the new item.

free_item(S) 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.

 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

See also

curses(S), menus(S)

Standards conformance

new_item(S) and free_item(S) are not part of any currently supported standard; they were developed by UNIX System Laboratories, Inc. and are maintained by The SCO Group.
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003