menu_pattern(3X) LIBRARY FUNCTIONS 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:
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).
1