Function: text.replace_all

Replaces all instances of a substring with a new string.

In the case of overlapping matches the leftmost instance is replaced. If the expression is empty, it matches at the beginning of the string and after each code point, yielding up to k+1 replacements for a string with k code points.

Arguments

Arguments
source

string

The subject of the function. A modified copy is returned.

substr

string

The substring for which all instances will be replaced.

repl

string

The string that will replace all instances of substr.

Returns

A copy of source where all matches of substr are replaced by repl.

Raised exceptions

Exceptions
TypeError If either source, substr, or repl is not a string.
ValueError If either substr or repl is not UTF-8 encoded.

Examples

# Replace substring instances; returns "Goodbye World"
- returnStep:
    return: ${text.replace_all("Hello World", "Hello", "Goodbye")}