STRINGREPLACE

This activity replaces one or more occurrences of one string in another string with a specified replacement string.

NOTE: For best performance, we advise that you limit use of activities such as this to non-intensive parts of your solution.  In particular, you should avoid extensive string manipulations at a process orchestration level inside iterative parts of your solution.  Extensive string manipulation is usually a task best performed in compiled program code.

INPUT Parameters:

STRINGIN: Required

This parameter specifies the string from which the substring is to be extracted.

STRINGOLD: Required

This parameter specifies the string to search for and that is to be replaced.

STRINGNEW: Optional

This parameter specifies the string that is to replace the occurrence(s) of STRINGOLD in STRINGIN.  The length does not have to match the length of STRINGOLD.

REPLACEALL: Optional

This parameter specifies whether just one or all occurrences of STRINGOLD in STRINGIN are to be replaced.  The default value is *YES, meaning that all occurrences will be replaced..  You can specify *NO if you only want the first occurrence to be replaced.

IGNORECASE: Optional

This parameter specifies whether the search is performed without regard to upper or lower case differences.  For example, if you specify *YES, then a search for 'abc' will find 'abc', 'ABC', aBc' and others.  This applies only to the search - the replacement will use the exact string provided by the STRINGNEW parameter.  The default value is *NO.

OUTPUT Parameters:

STRINGOUT:

Upon completion, this parameter will contain the resulting string.