NAME

menu_pattern, set_menu_pattern − set and get menus pattern match buffer

SYNOPSIS

#include <menu.h>

char ∗menu_pattern(MENU ∗menu);

int set_menu_pattern(MENU ∗menu, char ∗pat);

MT-LEVEL

Unsafe

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 VALUES

menu_pattern() returns NULL on error.  set_menu_pattern() returns one of the following:

E_OKThe routine returned successfully.
E_SYSTEM_ERRORSystem error.
E_BAD_ARGUMENTAn incorrect argument was passed to
the routine.
E_NO_MATCHThe character failed to match.

SEE ALSO

curses(3X), menus(3X)

NOTES

The header <menu.h> automatically includes the headers <eti.h> and <curses.h>. 

Sun Microsystems  —  Last change: 22 Jan 1993