$regsubex » History » Revision 5

« Previous | Revision 5/8 (diff) | Next »
Per Amundsen, 01/16/2019 10:33 PM

Added in 1.9.0

$regsubex([name], text, re, subtext, [%var|&binvar])

Performs a regular regular expression and then performs a substitution using subtext.

Returns the substituted text.

See also $regex, $regsub, $regml, $regmlex. $regerrstr.


[name] - Name of the search, which can later be referenced using $regml. (optional)
text - The text to search.
re - The 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)


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


; Find all lowercase 'a-z' characters and replace them with an uppercase character.
//echo -ag $regsubex(abcdefg,/([a-z])/g,$upper(\1))

Updated by Per Amundsen over 5 years ago · 5 revisions

Also available in: PDF HTML TXT