STRING::REPLACE_RE 1g 2024-03-26 laplante@plcb.ca GOWEB/STRING — Replace Using Regular Expressions

title: “STRING::REPLACE_RE” version: “1.0.0” date: 2024-03-26 author: “laplante@plcb.ca” section: “1g” category: “GOWEB/STRING”

Name

string::replace_re Replace Using Regular Expressions

Synopsis

string::replace_re(string, new_string, re/.../)
replace_re(string, new_string, re/.../)
string::replaceRe(string, new_string, re/.../)
replaceRe(string, new_string, re/.../)

Description

The replace_re function replaces parts of a string with new_string based on a regular expression match.

• The regular expression can appear anywhere in the argument list.
• The new_string parameter must immediately follow the string parameter.
• Supports capture groups and named groups in replacement using $1, ${1}, or $name.

Examples

res={{
    replace_re(re/a(x*)b/, "-ab-axxb-", "T"); "\n";
    replace_re(re/a(x*)b/, "", ""); "\n";
    replace_re(re/a(x*)b/, "-ab-axxb-", "$1"); "\n";
    replace_re(re/a(x*)b/, "-ab-axxb-", "$1W"); "\n";
    replace_re(re/a(x*)b/, "-ab-axxb-", "${1}W"); "\n"; "\n";

    replace_re(re/a(?P<1W>x*)b/, "-ab-axxb-", "$1W"); "\n";
    replace_re(re/a(?P<1W>x*)b/, "-ab-axxb-", "${1}W"); "\n";
}}.

Returns:

res=-T-T-

--xx-
---
-W-xxW-

--xx-
-W-xxW-

Author

laplante@plcb.ca

See Also

• string::replace
• string::find_all_string_submatch
• String functions
• Index

Version

• 1.0.0 — 2024-03-26 — Initial version