menu_pattern(3X)                  SDK R4.11                 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).


Licensed material--property of copyright holder(s)