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 keystroke; 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)