substitution substitution

Substitution string element. Optional in <rule> elements.

Attributes section-d955eefc53eb4274861270669c01f9ca


Data section-a2688866ed6d41279a8478886e511ae3

Substitution string.

Description section-b6ab78ca5b0b4d508c71e553566cc9f3

Defines a replacement string for the matched string or substring in the path or query.

If the pattern expression includes subexpressions (delimited with parentheses), the first matched substring is replaced with the substitution string. If the pattern expression does not include subexpressions, the entire matched string is substituted.

If <expression> is empty or absent, the substitution string is appended to the path or query.

If <substitution> is empty, the matched string or substring is removed. If <substitution> is not specified, the path or query string is not modified.

Note section-90fe89bb17a04804b7ff3c93df082892

The substitution string must not contain literal < and & characters. These reserved characters can be encoded with & and <, respectively, or the entire string can be enclosed in an XML CDATA section:

<substitution><![CDATA[&text=<Hello, world!>]]></ substitution>