{{>toc}} h1. Matchtext A 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: * - matches any text ? - matches any single letter & - matches any single word _See also [[$matchkey]], [[$stripped]]._ *Example*
; 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
h1. Regex text pattern The matchtext parameter can also be a [[Scripting Regex|Regular Expression]] Pattern by using the '$' event prefix. *Example*
on $*:text:/^!test$/i:#:{
  msg $chan Test Worked!
}
h1. Matchtext evaluation Matchtext can be evaluated using [[$]](code) or contain a single [[Scripting_Variables|%variable]]. *Example*
; 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