MatchEditor(3I) 					    InterViews Reference Manual 					   MatchEditor(3I)

NAME

       MatchEditor - StringEditor with pattern matching

SYNOPSIS

       #include <InterViews/matcheditor.h>

DESCRIPTION

       MatchEditor  is	a StringEditor subclass that checks the validity of its contents against a specified pattern.  It is suitable for entering
       strings that must conform to a particular format such as a number or a file name.  The matching pattern is specified according to the rules
       of  scanf(3).   For  example, a pattern of "%3d" will match a 3-digit integer, a pattern of "%[ab]" will match a string containing only a's
       and b's, and a pattern of "(%f, %f)" will match the string "(12.0, 5E23)".

PUBLIC OPERATIONS

       MatchEditor(ButtonState*, const char* sample, const char* done)
	      Create a new MatchEditor object.	The ButtonState, sample string, and termination string are passed to the StringEditor constructor.

       void Match(const char* pattern, boolean keystroke = true)
	      Specify the pattern to match against.  When MatchEditor performs matching, it will highlight any trailing part of  the  edit  string
	      that  does  not  conform to pattern.  The user can then correct the string.  If keystroke is true, matching will occur on every key-
	      stroke; otherwise matching will only occur on the completion of the edit.  The initial pattern matches any string, and  the  initial
	      value of keystroke is true.

RESTRICTIONS

       MatchEditor  uses  sscanf  internally to check the pattern match.  Different versions of sscanf have different scanning capabilities; check
       with your local version to see what patterns you can use.

SEE ALSO

       StringEditor(3I)

InterViews							    7 Dec 1989							   MatchEditor(3I)