Replaces occurrences of substring1 in a string with substring2,
in a specified scope. The search is case-sensitive. Function returns original string with replacements made.

replace(String, substring1, substring2 [, scope]) → returns string

replace Argument Reference

String string

String to search

substring1 string

Substring to find within string

substring2 string

Substring to replace substring1 with. As of CF 2016+ you can also pass a callback function in this argument function(pattern, position, originalString).

scope string
Default: one

* one: replace the first occurrence
* all: replace all occurrences
  • one
  • all

Examples sample code invoking the replace function

Replace in Script Syntax

getVal = replace("ColdFUsion", "U", "u"); 

Expected Result: Expected Result: ColdFusion

Something similar in Tag Syntax

getVal1 = replace("COldFusiOn", "O", "o", "ONE"); 

Expected Result: Expected Result: ColdFusiOn

In CF 2016+ you can pass in a callback function to the third argument of the replace function

public function upCase(pattern, position, orig) {
    return uCase(pattern);
result = replace("A man a plan a canal.","an", upCase , "ALL");

Expected Result: A mAN a plAN a cANal.

Fork me on GitHub