[Go to CFHT Home Page] Man Pages
Back to Software Index  BORDER=0Manpage Top Level
    menu_item_new(3X) manual page Table of Contents

Name

menu_item_new, new_item, free_item - create and destroy menus items

Synopsis

cc [ flag ... ] file ... -lmenu -lcurses [ library .. ]

#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_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.

See Also

curses(3X) , menus(3X)

Notes

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

Table of Contents