equals
Description
The equals operator lets you filter a grammar so that only forms where the field matches a particular regex are generated.
Like starts/ends/contains, rename and hide, equals applies to the content immediately to its left, but can be chained.
Usage examples
Say, for example, that the A symbol defines the fields text, gloss and class, and class can be either X, C1, or C2. The following code creates a symbol B that only contains entries where the class equals C1.
| B = | embed | equals class |
|---|---|---|
| A | C1 |
Below an equals operator, content is interpreted as a regex.
For example, we could filter A only to entries where the text starts with "p", "t", or "k":
| B = | embed | equals text |
|---|---|---|
| A | (p|t|k).* |
(There is also a special convenience operator for this, starts, that auto-generates a regex and would suffice for this particular use-case. However, if you have a more complex regex you wish to filter on, we recommend using equals and being explicit about which regex you want to match.)