$regsubex » History » Revision 3
Revision 2 (Per Amundsen, 08/13/2015 10:53 AM) → Revision 3/8 (Per Amundsen, 05/07/2017 11:15 PM)
_Added in 1.9.0_ *$regsubex([name], text, re, subtext, [%var|&binvar])* subtext)* Performs a regular [[Scripting_Regex|regular expression]] and then performs a substitution using subtext. Returns the substituted text. *Parameters* [name] - Name of the search, which can later be referenced using [[$regml]]. (optional) text - The text to search. re - The [[Scripting_Regex|regular expression]] to perform. subtext - Subtext to replace with. [%var|&binvar] - Optionally output the text to a %var or a &binvar. ([name] must be defined and returns the number of matches instead of the substituted text) *Subtext* The subtext evaluates identifiers before performing the substitution and special markers can be used to reference various parts of the result. \0 - Returns the number of matches. \n - Returns the current match number. \t - Returns the current match text (same as [[$regml]](\n)). \a - Returns all matching items. \A - Returns a non-spaced version of \a. \1 \2 \N ... - Returns the Nth back-reference made for a given match *Example* <pre> ; Find all lowercase 'a-z' characters and replace them with an uppercase character. //echo -ag $regsubex(abcdefg,/([a-z])/g,$upper(\1)) </pre>