menuitems(3X)                                                  menuitems(3X)



NAME
       menuitems - make and break connections between items and menus

SYNOPSIS
       ##include <>
       int setmenuitems(MENU *menu, ITEM **items);
       ITEM **menuitems(const MENU *menu);
       int itemcount(const MENU *menu);

DESCRIPTION
       The function setmenuitems changes the item pointer array of the given
       menu.  The array must be terminated by a NUL.

       The function menuitems returns the item array of the given menu.

       The function itemcount returns the count of items in menu.

RETURN VALUES
       The function menuitems returns NUL on error.

       The function itemcount returns ER (the general  curses  error  return
       value) on error.

       The  function  setmenuitems  returns  one  of  the following codes on
       error:

       EOK The routine succeeded.

       ESYSTEMEROR
            System error occurred (see errno).

       EBADARGUMENT
            Routine detected an incorrect or out-of-range argument.

       EPOSTED
            The menu is already posted.

       ENOTCONECTED
            No items are connected to the menu.

SEE ALSO
       curses(3X), menu(3X).

NOTES
       The  header  file  <>  automatically  includes  the  header  file
       <>.

PORTABILITY
       These  routines  emulate the System V menu library.  They were not sup-
       ported on Version 7 or BSD versions.

       The SVr4 menu library  documentation  specifies  the  itemcount  error
       value as -1 (which is the value of ER).

AUTHORS
       Juergen Pfeifer.  Manual pages and adaptation for new curses by Eric S.
       Raymond.



                                                                menuitems(3X)