AdiIRC

{{>toc}}

h1. Matchtext

A <matchtext> is a text pattern that AdiIRC will use to compare with something during a [[Scripting_Events|scripting event]].

h1. Wild characters

The matchtext can contain wild characters:

<notextile>* - matches any text</notextile>

<notextile>? - matches any single letter</notextile>

<notextile>& - matches any single word</notextile>

_See also [[$matchkey]], [[$stripped]]._

*Example*

<pre>

; The matchtext will only match if the ONLY word is "!test"

on *:TEXT:!test:*:echo -ag Match

; The matchtext will match if the text starts with "!test"

on *:TEXT:!test*:*:echo -ag Match

; The matchtext will match if the text ends with the word "!test"

on *:TEXT:*!test:*:echo -ag Match

; The matchtext will match any text that has "!test" in it (anywhere)

on *:TEXT:*!test*:*:echo -ag Match

; The matchtext will match any text that start with the word test !test and his only followed by a second word

on *:TEXT:!test &:*:echo -ag Match

</pre>

h1. Regex text pattern

The matchtext parameter can also be a [[Scripting Regex|Regular Expression]] Pattern by using the '$' event prefix.

*Example*

<pre>

on $*:text:/^!test$/i:#:{

  msg $chan Test Worked!

}

</pre>

h1. Matchtext Evaluation

Matchtext can be evaluated using [[$]](code) or contain a single [[Scripting_Variables|%variable]].

*Example*

<pre>

; Subscribe to the TEXT event, try evaluate my nick, and if it matches, print a text.

on *:TEXT:$(* $+ $me $+ *)):*:echo -ag My nick was highlighted on $chan

; Set a variable

set %variable !test

; Subscribe to the TEXT event, if the messages matches the variable, print a text.

on *:TEXT:%variable:*:echo -ag Text !test was matched

</pre>