string->replace

Replaces text or regular expression matches.

Target member

Signature

1string->replace(find::string, replace::string, -case::boolean= ?)

Replaces text or regular expression matches.

string->replace is called with member syntax on a receiver value. string->replace works with text values. Normalize input at boundaries, escape at output boundaries, and keep encoding calls close to the place where the encoded text is needed.

Parameters

find: Required value of type string. Supply find positionally unless the signature shows a keyword form.
replace: Required value of type string. Supply replace positionally unless the signature shows a keyword form.
-case: Optional value of type boolean. Supply -case by keyword, keeping the leading hyphen in the call.

Examples

Basic call

1'a-b'->replace('-', ':')

The example shows the receiver and result shape. In templates, apply escaping at the final output boundary.