menu_pattern(S-osr5)

menu_pattern: set_menu_pattern, menu_pattern -- set and get menu pattern match buffer

Syntax

cc ... -lmenu -lcurses

#include <menu.h>

int set_menu_pattern(MENU *menu, char *pat);
char *menu_pattern(MENU *menu);

Description

set_menu_pattern- set the menu pattern buffer to the specified pattern

menu_pattern- return the current menu pattern

Every menu has a pattern buffer to match entered data with menu items. set_menu_pattern(S-osr5) 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(S-osr5) 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_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.

Warning

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

Files

/usr/lib/libmenu.a: the library

Standards conformance

set_menu_pattern(S-osr5), and menu_pattern(S-osr5) are not part of any currently supported standard; they were developed by UNIX System Laboratories, Inc. and are maintained by The SCO Group.

`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.