Added in 1.9.6
$regbr([name], N, [&binvar])
Returns the Nth regular expression match from $regex, $regsub, $regsubex or from an event.
Same as $regml.
Parameters
| Parameter | Description |
| [name] | A named regular expression, if not defined result from the last regular expression is returned. (optional) |
| N | If N = 0, number of matches, otherwise the Nth match. |
| [&binvar] | TODO |
Properties
| Property | Description |
| .pos | Returns the match position in the text. |
| .group | Returns the group position (includes empty groups). |
Example
; 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)