Project

General

Profile

$regml » History » Version 15

Per Amundsen, 07/24/2020 03:10 PM

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