replace

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

replace(string, substring1, obj [, scope]) → returns string

Member Function Syntax

string.replace(substring1, obj[, scope])

Argument Reference

string string
Required

String to search

substring1 string
Required

Substring to find within string

obj any
Required

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

scope string
Default: one

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

start numeric
Default: 1

CF 2021+ Position to start searching in the string.

Links more information about replace

Examples
Sample code invoking the replace function

Replace in Script Syntax

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

Expected Result: ColdFusion

Something similar in Tag Syntax

<cfset getVal1 = replace("COldFusiOn", "O", "o", "ONE") />
<cfdump var = #getVal1# />

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");
writeOutput(result);

Expected Result: A mAN a plAN a cANal.

In CF 2021+ you can pass position to start searching in the string

getRes = replace("Love ColdFusion", "o", "O","ALL","3");
writeOutput(getRes);

Expected Result: Love COldFusiOn

Signup for cfbreak to stay updated on the latest news from the ColdFusion / CFML community. One email, every friday.

Fork me on GitHub