4 \fBmenu_pattern\fR - get and set a menu's pattern buffer
6 \fB#include <menu.h>\fR
8 int set_menu_pattern(MENU *menu, const char *pattern);
10 char *menu_pattern(const MENU *menu);
13 Every menu has an associated pattern match buffer. As input events that are
14 printable ASCII characters come in, they are appended to this match buffer
15 and tested for a match, as described in \fBmenu_driver\fR(3x).
17 The function \fBset_menu_pattern\fR sets the pattern buffer for the given menu
18 and tries to find the first matching item. If it succeeds, that item becomes
19 current; if not, the current item does not change.
21 The function \fBmenu_pattern\fR returns the pattern buffer of the given
24 The function \fBmenu_pattern\fR returns \fBNULL\fR on error. The function
25 \fBset_menu_pattern\fR may return the following error codes:
28 The routine succeeded.
31 System error occurred (see \fBerrno\fR).
34 Routine detected an incorrect or out-of-range argument.
37 Character failed to match.
39 \fBcurses\fR(3X), \fBmenu\fR(3X).
41 The header file \fB<menu.h>\fR automatically includes the header file
44 These routines emulate the System V menu library. They were not supported on
45 Version 7 or BSD versions.
47 Juergen Pfeifer. Manual pages and adaptation for new curses by Eric
50 .\"# The following sets edit modes for GNU EMACS