menu_pattern(3X)               DG/UX R4.11MU05              menu_pattern(3X)


NAME
       menu_pattern:  set_menu_pattern, menu_pattern - set and get menus
       pattern match buffer

SYNOPSIS
       #include <menu.h>

       int set_menu_pattern(MENU *menu, char *pat);
       char *menu_pattern(MENU *menu);

DESCRIPTION
       Every menu has a pattern buffer to match entered data with menu
       items.  set_menu_pattern 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.  menu_pattern returns the string in the pattern
       buffer of menu.

RETURN VALUE
       menu_pattern returns NULL on error.  set_menu_pattern returns one of
       the following:
       E_OK           - The routine returned successfully.
       E_SYSTEM_ERROR - System error.
       E_BAD_ARGUMENT - An incorrect argument was passed to the routine.
       E_NO_MATCH     - 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)