Replace - Revision history

SebNozzi: Formatting of Usage Notes

2023-11-17T21:49:53Z

Formatting of Usage Notes

SebNozzi: Change header from "Default value" to "Type"

2023-11-17T21:43:53Z

Change header from "Default value" to "Type"

JoeStrout: fixed typo in example

2021-05-28T13:17:52Z

fixed typo in example

JoeStrout at 16:11, 18 March 2020

2020-03-18T16:11:48Z

JoeStrout: /* Arguments */

2020-03-18T16:11:21Z

Arguments

71.226.33.30 at 16:01, 17 March 2020

2020-03-17T16:01:18Z

71.226.33.30: Created page with "replace Replace all matching elements of a list or map, or substrings of a string, with a new value. === Arguments === {| class="wikitable" |- ! Parameter Name !! De..."

2020-03-17T16:00:28Z

Created page with "<c>replace</c> Replace all matching elements of a list or map, or substrings of a string, with a new value. === Arguments === {| class="wikitable" |- ! Parameter Name !! De..."

New page

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

=== Arguments ===

{| class="wikitable"
|-
! 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 ==

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

[[Category:Intrinsic Functions]]
[[Category:List Methods]]
[[Category:String Methods]]
[[Category:Map Methods]]

← Older revision		Revision as of 16:11, 18 March 2020
Line 1:		Line 1:
−	<c>replace</c> ~~Replace~~ all matching elements of a list or map, or substrings of a string, with a new value.	+	<c>replace</c> replaces all matching elements of a list or map, or substrings of a string, with a new value.

@@ Line 21: / Line 21: @@
 === 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 ==

@@ Line 6: / Line 6: @@
 {| class="wikitable"
 |-
-! Parameter Name !! Default Value !! Meaning
+! Parameter Name !! Type !! Meaning
 |-
 | ''self'' || list, map or string || object to replace elements of

@@ Line 26: / Line 26: @@
 <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>

@@ Line 12: / Line 12: @@
 | ''oldval'' || any || value or substring to replace
 |-
-| ''newval'' || any || new value or substring to substitute where oldval
+| ''newval'' || any || new value or substring to substitute where oldval is found
 |-
 | ''maxcount'' || number, optional || if given replace no more than this many.