Replaces all matches of a regular expression with a new string.

In the case of overlapping matches, the leftmost instance is replaced and ifmultiple matches start at the same index, then the longest one is replaced.If the expression is empty, it matches at the beginning of the string andafter each code point, yielding up tok+1 replacements for a string withk code points.

Note that regular expression backreferences are not supported and you can'trefer to text previously matched by a capturing group.

Arguments

Returns

A copy ofsource where all matches ofregexp are replaced byrepl.

Raised exceptions

Examples

# Replace matches of regular expression; returns "three three"-returnStep:return:${text.replace_all_regex("one two", "one|two", "three")}