Replace

From MiniScript Wiki
Jump to navigation Jump to search

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"}