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 scan-
       ning capabilities; check with your local  version  to  see
       what patterns you can use.

SEE ALSO

       StringEditor(3I)