Matchtext » History » Revision 10
Revision 9 (Per Amundsen, 11/14/2015 10:24 AM) → Revision 10/11 (Per Amundsen, 02/24/2017 09:31 PM)
{{>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>