menuitems(3X) menuitems(3X)

NAME
       mmeennuuiitteemmss - make and break connections between items and menus

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

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

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

       The function iitteemmccoouunntt returns the count of items in menu.

RETURN VALUES
       The function mmeennuuiitteemmss returns NNUULLLL on error.

       The function iitteemmccoouunntt returns EERRRR (the general  ccuurrsseess  error  return
       value) on error.

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

       EEOOKK The routine succeeded.

       EESSYYSSTTEEMMEERRRROORR
            System error occurred (see eerrrrnnoo).

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

       EEPPOOSSTTEEDD
            The menu is already posted.

       EENNOOTTCCOONNNNEECCTTEEDD
            No items are connected to the menu.

SEE ALSO
       ccuurrsseess(3X), mmeennuu(3X).

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

PPOORRTTAABBIILLIITTYY
       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  iitteemmccoouunntt  error
       value as -1 (which is the value of EERRRR).

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



                                                                menuitems(3X)