Chainable reader

<replaceAll>

A filter reader that replaces all matches of a regular expression with a replacement string.

The pattern search is stream-oriented, not line-oriented, i.e. matches are found even across line boundaries. Thus the pattern typically enables (?m) (multi-line mode) and/or (?s) (dotall mode).

This filter reader is semantically almost equivalent with

  <tokenfilter>
    <filetokenizer />
    <replaceregex
      pattern="regex"
      flags="s"
      replace="replacement-string"
    />
  </tokenfilter>

, but is much more efficient in many cases, because the <filetokenizer /> always reads the entire content into memory, while <replaceAll /> processes the content in a "sliding" manner which requires only very little memory if the regex matches relative short sequences.

Attribute Summary

Attributes

Name	Description
pattern="..."	The pattern to search for in the content.
replacementExpression="..."	A "replacement expression" to use for the substitution of each match.
replacementString="..."	The "replacement string" to use for the substitution of each match.

Subelement Summary

Subelements

Name	Description
<pattern>	Another replacement specification (this filter reader can execute multiple replacements in a row).

Attribute Detail

Default values are underlined.

pattern="pattern"

The pattern to search for in the content.

replacementString="replacement-string"

The "replacement string" to use for the substitution of each match.

replacementExpression="replacement-expression"

A "replacement expression" to use for the substitution of each match.

Usage example:

replacementExpression="m.group.toUpperCase()"

Subelement Detail

<pattern>

Another replacement specification (this filter reader can execute multiple replacements in a row).

Text between start and end tag:

Attributes:

pattern="pattern"

replacementString="replacement-string"

The "replacement string" to use for the substitution of each match.

replacementExpression="replacement-expression"

A "replacement expression" to use for the substitution of each match.

Usage example:

replacementExpression="m.group.toUpperCase()"