$regbr » History » Revision 3
Revision 2 (Per Amundsen, 03/30/2016 03:19 PM) → Revision 3/4 (Per Amundsen, 07/24/2020 03:10 PM)
_Added in 1.9.6_ *$regbr([name], N, [&binvar])* N)* Returns the Nth [[Scripting_Regex|regular expression]] match from [[$regex]], [[$regsub]], [[$regsubex]] or from an [[Scripting_Events|event]]. _Same as [[$regml]]._ *Parameters* [name] - A named [[Scripting_Regex|regular expression]], if not defined result from the last [[Scripting_Regex|regular expression]] is returned. (optional) N - If N = 0, number of matches, otherwise the Nth match. [&binvar] - *TODO* *Properties* .pos - Returns the match position in the text. .group - Returns the group position (includes empty groups). *Example* <pre> ; Search the text for the pattern '(hello)' and print the result. //echo -ag Number of matches: $regex(Hello World, /(Hello)/) match 1 is: $regbr(1) ; Prefix an event with '$' allows the use of a regular expression in the 'matchtext' field which will fill $regbr with the result. on $*:TEXT:/Hello/g:*:echo -ag found $regbr(0) matches, first match was $regbr(1) </pre>