menu_pattern(3X)                                           menu_pattern(3X)


   NAME
         menupattern:  setmenupattern, menupattern - set and get menus
         pattern match buffer

   SYNOPSIS
         #include <menu.h>

         int setmenupattern(MENU *menu, char *pat);
         char *menupattern(MENU *menu);

   DESCRIPTION
         Every menu has a pattern buffer to match entered data with menu
         items.  setmenupattern sets the pattern buffer to pat and tries to
         find the first item that matches the pattern.  If it does, the
         matching item becomes the current item.  If not, the current item
         does not change.  menupattern returns the string in the pattern
         buffer of menu.

   RETURN VALUE
         menupattern returns NULL on error.  setmenupattern returns one of
         the following:
         EOK           - The routine returned successfully.
         ESYSTEMERROR - System error.
         EBADARGUMENT - An incorrect argument was passed to the routine.
         ENOMATCH     - The character failed to match.

   NOTES
         The header file <menu.h> automatically includes the header files
         <eti.h> and <curses.h>.

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





















   8/91                                                                 Page 1