Replace

replace Replace all matching elements of a list or map, or substrings of a string, with a new value.

Arguments

Parameter Name	Default Value	Meaning
self	list, map or string	object to replace elements of
oldval	any	value or substring to replace
newval	any	new value or substring to substitute where oldval is found
maxcount	number, optional	if given replace no more than this many.

Usage Notes

Lists and maps are mutated in place, and return themselves. Strings are immutable, so the original string is (of course) unchanged, but a new string with the replacement is returned. Note that with maps, it is the values that are searched for and replaced, not the keys.

Example

"Happy Pappy".replace("app", "ol")	// returns "Holy Poly"
[1,2,3,2,5].replace(2, 42)	// returns (and mutates to) [2, 42, 3, 42, 5]
d = {1: "one"}; d.replace("one", "ichi").  // returns (and mutates to) {1: "ichi"}