$regsubex » History » Revision 4
Revision 3 (Per Amundsen, 05/07/2017 11:15 PM) → Revision 4/8 (Per Amundsen, 01/16/2019 09:16 PM)
_Added in 1.9.0_
*$regsubex([name], text, re, subtext, [%var|&binvar])*
Performs a regular [[Scripting_Regex|regular expression]] and then performs a substitution using subtext.
Returns the substituted text.
_See also [[$regex]], [[$regml]], [[$regmlex]]._
*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>