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.
Parameters
| Parameter | Description |
| [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) |
Subtext
| Character | Description |
| \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. |
| \@ | Returns the total number of matches. (AdiIRC only) |
| \1 \2 \N ... | Returns the Nth back-reference made for a given match |
The subtext evaluates identifiers before performing the substitution and special markers can be used to reference various parts of the result.
Example
; Find all lowercase 'a-z' characters and replace them with an uppercase character. //echo -ag $regsubex(abcdefg,/([a-z])/g,$upper(\1))