Definition: |
include builtins\regex.e
string res = gsub(string re, string target, string rep) |
Description: |
Draft - this is a very simple routine that took very little time or effort (or thought) to write, and may
change in later releases.
Applies the regular expression re (in string or pre-compiled format) to target and returns rep with with all non-overlapping matches substituted with rep. re: a regular expression such as "a(b*)" or the result of applying regex_compile() to such a string. target: a string to be matched against the regular expression. rep: a replacement string, which may contain '&' to denote the match. Returns: target unaltered if re does not match, otherwise target with each match replaced by rep. If rep contains &, that will be substituted with the match as part of each substitution. |
Example: |
?gsub("[A-Z]","abCDefG","*") -- "ab**ef*" ?gsub("[A-Z]","abCDefGH","(&)") -- "ab(C)(D)ef(G)(H)" ?gsub("[A-Z]+","abCDefGH","(&)") -- "ab(CD)ef(GH)" |
See Also: | gmatch |
