AdiIRC

_Added in 1.9.0_

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

Performs a regular [[Scripting_Regex|regular expression]] and then performs a substitution using subtext.

Returns the number of substitutions made, and assigns the result to %var or &binvar.

_See also [[$regex]], [[$regsubex]], [[$regml]], [[$regmlex]]. [[$regerrstr]]._

*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 - Variable to assign the result to.

*Example*

<pre>

alias Example {

  ; Create a local variable.

  var %Example

  ; Perform a search for '([O])' and replace it with 'o' and fill the variable %Example with the result.

  noop $regsub(name,HellO WOrld,/([O])/g,o,%Example)

  ; Print the result.

  echo -a $regml(name,0) : $regml(name,1) -- $regml(name,2) : %Example

}

</pre>