<@REPLACE>

Syntax

<@REPLACE STR=string FINDSTR=findString
REPLACESTR=replaceString [POSITION=position]
[ENCODING=encoding]>

Description

Returns a text string in which all the occurrences of FINDSTR in the value specified in STR are replaced with the substitute as specified in REPLACESTR. If the POSITION attribute is specified, only that occurrence of FINDSTR is replaced.

Strings that contain spaces must be quoted.

If a syntax error is encountered while the expression is parsed--no attributes at all, no string, no keyword, no substitute, or no occurrence--the tag returns an empty string.

<@REPLACE> is case insensitive.

Examples

<@REPLACE STR="alpha" FINDSTR="a" REPLACESTR="u" POSITION="2">

This example returns "alphu", replacing the second occurrence of "a".

<@REPLACE STR="<@INCLUDE FILE='<@APPFILEPATH>BrownFox.txt'>" FINDSTR="<@INCLUDE FILE='<@APPFILEPATH>BrownFox.txt'>" REPLACESTR="A">

This example replaces "The Quick Brown Fox Jumps Over A Lazy Dog" (the content of the BrownFox.txt file) with "A".

See Also

Encoding Attribute
<@LEFT>
<@LOCATE>
<@REGEX>
<@REPLACE>
<@RIGHT>
<@SUBSTRING>