---
name: "MatchEditor"
section: "3"
platform: "linux"
package: "ivtools-dev"
version: "1.1.3-4"
release: "Debian 3.1 (Sarge)"
platforms: ["linux"]
url: "https://new.carta.tech/MatchEditor"
---

# MatchEditor(3)

StringEditor with pattern matching

## 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)](/scanf/3.md).  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)