Syntax

   FACTORY_DEF <ReaderKeyword> StringReplacerFactory
   [FACTORY_NAME <factory name>]
   [INPUT FEATURE_TYPE <factory type>
      [<attribute name> <attribute value>]*
      [<feature function>]*]*
   USE_REGEX <YES|NO>
   CASE_SENSITIVE <YES|NO>
   SOURCE_ATTRIBUTES <attribute name>[,<attribute name>]*
   FIND_TEXT <search string>
   REPLACE_TEXT <replacement text>
   [REPLACE_NO_MATCH <replacement text for no match>]
   [OUTPUT OUTPUT FEATURE_TYPE <feature type>
      [<attribute name> <attribute value>]*
      [<feature function>]*]*

Overview

   This factory is used to replace strings in attribute values. Each instance of
   FIND_TEXT will be replaced with REPLACE_TEXT if specified. If an attribute
   value does not match the FIND_TEXT and REPLACE_NO_MATCH is specified, the
   attribute value will be set to the value of REPLACE_NO_MATCH.
   Values will be stored in their original encoding, unless doing so would cause
   replacement characters to be used. If so, the value is encoded using Utf-8.

   USE_REGEX

      Whether the FIND_TEXT should be treated as a regular expression or simple
      string search.

   CASE_SENSITIVE

      Whether the FIND_TEXT should be matched in a case sensitive manner. If NO,
      'FIND_TEXT a' will match both 'a' and 'A'.

   SOURCE_ATTRIBUTES

      A FMEParsableText-encoded list of attribute names, space separated.

   FIND_TEXT

      The text to search for in attributes.

   REPLACE_TEXT

      Matches of FIND_TEXT will be replaced with this value. May be empty string
      in which case matches will effectively be removed from the source value.

   REPLACE_NO_MATCH

      Optional. If present, attribute values that do not contain any matches will
      be overwritten with this value.
      Possible values:
          _FME_NO_OP_    - Ignore values that have no match. Same effect as
                           not having the clause.
          FME_NULL_VALUE - Attributes that have no match will be set to NULL
          <value>        - Attributes that have no match will be set to 'value'
                           May be empty, in which case values with no match will
                           be truncated, but not set to NULL.

Output Tags

   The StringReplacerFactory supports the following output tags:

   OUTPUT

      The output features.