Replace

From MiniScript Wiki
Revision as of 21:43, 17 November 2023 by SebNozzi (talk | contribs) (Change header from "Default value" to "Type")
Jump to navigation Jump to search

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


Arguments

Parameter Name Type 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"}