menu_pattern(3curses)                          menu_pattern(3curses)


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

       SYNOPSIS
             cc [flag . . .] file -lmenu -lcurses [library . . .]
             #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.

       NOTICES
             The header file menu.h automatically includes the header files
             eti.h and curses.h.

       REFERENCES
             curses(3curses), menus(3curses)
















                           Copyright 1994 Novell, Inc.               Page 1