Contains Condition
The Contains Condition can be used to check whether string, variable value or file content contains a given pattern.
The pattern can be a plain string or a regular expression.
Usage
Example:
<condition type="contains" id="...">
<string>a string</string>
<value>a substring</value>
</condition>
<condition type="contains" id="...">
<variable>a variable</variable>
<value>a substring</value>
</condition>
<condition type="contains" id="...">
<file>a string</file>
<value caseInsensitive="false" regex="false">a substring</value>
</condition>
The Contains condition has been introduced in IzPack 5.0.
Nested Elements
<string>
A source string where to look up the pattern.
Variable substitution takes places before the string is processed by the condition.
Optional, one of the elements <string>, <variable> or <file> must be given to deliver a source for parsing.
<variable>
A variable name, the pattern is looked up in the variable's value.
Optional, one of the elements <string>, <variable> or <file> must be given to deliver a source for parsing.
<file>
A text file name, the pattern is looked up in the file's content.
Variable substitution takes places before the file name is processed by the condition.e
Optional, one of the elements <string>, <variable> or <file> must be given to deliver a source for parsing.
Be aware that the given file is opened and parsed quite many times during an installation process each time conditions get to be evaluated, to not slow down the installation process that much.
<value>
The substring or regular expression to look up in the contents.
A value must be given in each case.
Attributes:
| Name | Required | Default Value | Description |
|---|---|---|---|
| no | true | Beginning with version 5.0.9 the regex patterns do match to partial contents also (see IZPACK-1408). Therefore the attribute Whether to look up an entry on each line separately or just on a compact content. |
| no | false | Whether to look up case-insensitive. |
| no | false | Whether the value should be considered a Java regular expression pattern for looking up a content. |