Ada95/html/mitem_new.3x.html

   1 <HTML>
   2 <BODY BGCOLOR="#99ccbb" TEXT="#000000" LINK="#4060b0" VLINK="#000080" ALINK="#ff4040">
   3 <PRE>
   4        <STRONG>mitem_new</STRONG> - create and destroy menu items
   5
   6
   7 </PRE>
   8 <H2>SYNOPSIS</H2><PRE>
   9        <STRONG>#include</STRONG> <STRONG>&lt;menu.h&gt;</STRONG>
  10        ITEM *new_item(const char *name, const char *description);
  11        int free_item(ITEM *item);
  12
  13
  14 </PRE>
  15 <H2>DESCRIPTION</H2><PRE>
  16        The function <STRONG>new_item</STRONG> allocates a new item and initializes
  17        it from the <STRONG>name</STRONG> and <STRONG>description</STRONG> pointers.
  18        The function <STRONG>free_item</STRONG> de-allocates an item.
  19
  20
  21 </PRE>
  22 <H2>RETURN VALUE</H2><PRE>
  23        The function <STRONG>new_item</STRONG> returns <STRONG>NULL</STRONG> on error.
  24
  25        The function <STRONG>free_item</STRONG> returns one of the following:
  26
  27        <STRONG>E_OK</STRONG> The routine succeeded.
  28
  29        <STRONG>E_SYSTEM_ERROR</STRONG>
  30             System error occurred (see <STRONG>errno</STRONG>).
  31
  32        <STRONG>E_BAD_ARGUMENT</STRONG>
  33             Routine  detected  an incorrect or out-of-range argu-
  34             ment.
  35
  36        <STRONG>E_CONNECTED</STRONG>
  37             Item is connected to a menu.
  38
  39
  40 </PRE>
  41 <H2>SEE ALSO</H2><PRE>
  42        <STRONG><A HREF="ncurses.3x.html">curses(3X)</A></STRONG>, <STRONG><A HREF="menu.3x.html">menu(3X)</A></STRONG>.
  43
  44
  45 </PRE>
  46 <H2>NOTES</H2><PRE>
  47        The header file <STRONG>&lt;menu.h&gt;</STRONG> automatically includes the header
  48        file <STRONG>&lt;curses.h&gt;</STRONG>.
  49
  50
  51 </PRE>
  52 <H2>PORTABILITY</H2><PRE>
  53        These  routines  emulate  the System V menu library.  They
  54        were not supported on Version 7 or BSD versions.
  55
  56
  57 </PRE>
  58 <H2>AUTHORS</H2><PRE>
  59        Juergen Pfeifer.  Manual  pages  and  adaptation  for  new
  60        curses by Eric S. Raymond.
  61
  62
  63
  64
  65
  66
  67
  68
  69
  70 </PRE>
  71 </BODY>
  72 </HTML>