| General syntax | <attribute name="regexp" [value="regexp" regexpid="id_name" invert="false"] /> |
| Description | Tests if an attribute exists. The optional value defined matches if the attribute has the given value. For each positive matching attribute, all child instructions of the node will be executed. This test is an alias instruction for the test Element. |
| Attributes | Name | Use | Annotation |
| name | required | Defines the name of attribute. It can be either a string or any Regular Expression. |
| value | optional | Defines the value of ‘name’. The value can be either a string or any Regular Expression reference. If the optional attribute value is omitted, then the test will basically just execute an existence check. If the value attribute is defined, then the test is successful if the value matches the pattern. |
| regexpid | optional | Defines the unique id within the namespace to reference the test using regular expressions. Allowed character set: [p{Alnum}\_\-] = [a-z A-Z 0-9 _ -] |
| invert | optional | The Boolean value “true” inverts the behavior of the instruction. If the attribute is not configured, the default value “false” is used and the behavior of the instruction is not inverted. If the value is set to true and the criteria do not match, the child instructions will be executed. |
| Examples | <!-- tests the given attribute if the name starts with SYMBOL_ by using a
regular expression-->
<attribute name="SYMBOL_(.*)" />
<!-- tests the given attribute if the name starts with SYMBOL_ by using a regular expression
and if its value starts with SYM -->
<attribute name="SYMBOL_(.*)" value="SYM(.*)/> |