Difference between revisions of "Replace"

From MiniScript Wiki
Jump to navigation Jump to search
m (fixed typo in example)
Line 26: Line 26:
  
 
<ms>"Happy Pappy".replace("app", "ol") // returns "Holy Poly"
 
<ms>"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]
+
[1,2,3,2,5].replace(2, 42) // returns (and mutates to) [1, 42, 3, 42, 5]
 
d = {1: "one"}; d.replace("one", "ichi").  // returns (and mutates to) {1: "ichi"}</ms>
 
d = {1: "one"}; d.replace("one", "ichi").  // returns (and mutates to) {1: "ichi"}</ms>
  

Revision as of 13:17, 28 May 2021

replace replaces 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) [1, 42, 3, 42, 5]
d = {1: "one"}; d.replace("one", "ichi").  // returns (and mutates to) {1: "ichi"}