MirOS Manual: menu_pattern(3), set_menu_pattern(3)


menu_pattern(3)     UNIX Programmer's Manual      menu_pattern(3)

NAME

     menu_pattern - get and set a menu's pattern buffer

SYNOPSIS

     #include <menu.h>
     int set_menu_pattern(MENU *menu, const char *pattern);
     char *menu_pattern(const MENU *menu);

DESCRIPTION

     Every menu has an associated pattern match buffer.  As input
     events that are printable ASCII characters come in, they are
     appended to this match buffer and tested for a match, as
     described in menu_driver(3).

     The function set_menu_pattern sets the pattern buffer for
     the given menu and tries to find the first matching item.
     If it succeeds, that item becomes current; if not, the
     current item does not change.

     The function menu_pattern returns the pattern buffer of the
     given menu.

RETURN VALUE

     The function menu_pattern returns NULL on error.  The func-
     tion set_menu_pattern may return the following error codes:

     E_OK The routine succeeded.

     E_SYSTEM_ERROR
          System error occurred (see errno).

     E_BAD_ARGUMENT
          Routine detected an incorrect or out-of-range argument.

     E_NO_MATCH
          Character failed to match.

SEE ALSO

     curses(3), menu(3).

NOTES

     The header file <menu.h> automatically includes the header
     file <curses.h>.

PORTABILITY

     These routines emulate the System V menu library.  They were
     not supported on Version 7 or BSD versions.

AUTHORS

     Juergen Pfeifer.  Manual pages and adaptation for new curses
     by Eric S. Raymond.

MirOS BSD #10-current  Printed 03.04.2017                       1

Generated on 2017-04-03 16:26:17 by $MirOS: src/scripts/roff2htm,v 1.88 2017/01/29 00:51:06 tg Exp $

These manual pages and other documentation are copyrighted by their respective writers; their source is available at our CVSweb, AnonCVS, and other mirrors. The rest is Copyright © 2002–2017 The MirOS Project, Germany.
This product includes material provided by mirabilos.

This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report — diffs preferred.