AdiIRC

_Added in 2.4_

*$regmlex([name], M, N, [&binvar])*

Returns the Nth [[Scripting_Regex|regular expression]] capture group from the Mth match from [[$regex]], [[$regsub]], [[$regsubex]] or from an [[Scripting_Events|event]].

_See also [[$regsubex]], [[$regsub]], [[$regex]], [[$regml]], [[$regerrstr]]._

*Parameters*

table(ktable).

|*Parameter*|*Description*|

| [name] | A named [[Scripting_Regex<notextile>|</notextile>regular expression]], if not defined result from the last [[Scripting_Regex<notextile>|</notextile>regular expression]] is returned. (optional) |

| M | If M = 0, number of matches, otherwise the Mth match. |

| N | The Nth group. |

| [&binvar] | Adds the match to the specified &binvar instead. (changes return value to number of bytes added) |

*Properties*

table(ktable).

|*Property*|*Description*|

| .pos | Returns the match position in the text. |

| .group | Returns the group position (includes empty groups). |

*Example*

<pre>

; Search the text for the pattern 'abcdef' and print the result.

//echo -ag Number of matches: $regex(abcdef,/([a-z])([a-z])/g) - $regmlex(1,1) $regmlex(1,2) $regmlex(2,1) $regmlex(2,2)

</pre>