$regsub » History » Revision 2
Revision 1 (Per Amundsen, 08/13/2015 10:46 AM) → Revision 2/6 (Per Amundsen, 08/13/2015 10:46 AM)
_Added in 1.9.0_ 
 *$regsub([name], text, re, subtext, %var)* 
 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. 
 *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 - 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>