Search

api:match

Version 25.3.9411

api:match

The api:match keyword is similar to the api:equals keyword; however, it permits complex matching rules.

Parameters

  • pattern: The pattern to match.

  • type: The type of matches to find. The default is exact, which requires an exact match of the value. In this case api:match is identical to api:equals. Other supported types are regex, for regular expression matching, and glob, which supports a simple expression model similar to the one used in file-name patterns such as *.txt.

    Note: The .NET edition of the application uses the .NET Framework version of regular expression matching. The Cross-Platform edition uses Java regular expression constructs.

  • value: The value to match.

Control Attributes

None

Example

Check for floating point numbers using a regex pattern. If the pattern is matched, then the item is pushed out.

<api:match pattern="[-+]?[0-9]*.?[0-9]*" type="regex" value="-3.14">
  <api:push/>
</api:match>

See Also