$regbr » History » Version 2
Per Amundsen, 03/30/2016 03:19 PM
1 | 1 | Per Amundsen | _Added in 1.9.6_ |
---|---|---|---|
2 | |||
3 | *$regbr([name], N)* |
||
4 | |||
5 | Returns the Nth [[Scripting_Regex|regular expression]] match from [[$regex]], [[$regsub]], [[$regsubex]] or from an [[Scripting_Events|event]]. |
||
6 | |||
7 | _Same as [[$regml]]._ |
||
8 | |||
9 | *Parameters* |
||
10 | |||
11 | [name] - A named [[Scripting_Regex|regular expression]], if not defined result from the last [[Scripting_Regex|regular expression]] is returned. (optional) |
||
12 | N - If N = 0, number of matches, otherwise the Nth match. |
||
13 | |||
14 | 2 | Per Amundsen | *Properties* |
15 | |||
16 | .pos - Returns the match position in the text. |
||
17 | .group - Returns the group position (includes empty groups). |
||
18 | |||
19 | 1 | Per Amundsen | *Example* |
20 | |||
21 | <pre> |
||
22 | ; Search the text for the pattern '(hello)' and print the result. |
||
23 | //echo -ag Number of matches: $regex(Hello World, /(Hello)/) match 1 is: $regbr(1) |
||
24 | |||
25 | ; Prefix an event with '$' allows the use of a regular expression in the 'matchtext' field which will fill $regbr with the result. |
||
26 | on $*:TEXT:/Hello/g:*:echo -ag found $regbr(0) matches, first match was $regbr(1) |
||
27 | </pre> |