Sun Microsystems Logo
Products and Services
 
Support and Training
 
 

A  B  C  D  E  F  G  H  I  J  K  L  M  N  O  P  Q  R  S  T  U  V  W  X  Y  Z  
 
Curses Library Functionsmenu_item_new(3CURSES)


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

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.


ATTRIBUTES

 

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
MT-LevelUnsafe

SEE ALSO

 

curses(3CURSES), menus(3CURSES), attributes(5)


NOTES

 

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



SunOS 5.9Go To TopLast Changed 31 Dec 1996


Updated: 2004-01-16, 17:36