on text
Indice
- Contents
- Synopsis
- Level
- Matchtext
- Wildcard text pattern
- The basic text pattern
- RegEx text pattern
- Dynamic text pattern
- Target
- Local $identifier available in the on text event
- See also
The on text event is a mIRC event that triggers when a remote user (I.E. not the local user) receives a channel or a query message.
Synopsis
on <level>:text:<matchtext>:<target>:<commands>Level
- The appropriate access level”) for the event.
Matchtext
A
Wildcard text pattern
The matchtext can contain wild characters:
- * - matches any text
- ? - matches any single letter
- & - matches any single word
For Example:
- !test - the matchtext will only match if the ONLY word is “!test”
- !test* - the matchtext will match if the text starts with “!test”
- *!test - the matchtext will match if the text ends with the word “!test”
- *!test* - the matchtext will match any text that has “!test” in it (anywhere)
- !test & - the matchtext will match any text that start with the word test !test and his only followed by a second word
The basic text pattern
The most basic on text event is the normal wildcard pattern:
on *:text:!help:#:{
notice $nick For Help just state your question and pastebin any relevant code.
}Sometimes we want to get the user’s input. We can use the & to match a single word (in this case it will be a name, although it doesn’t matter)
on *:text:!color &:?:{
var %color = $gettok(white black red blue brown yellow orange green, $rand(1, 8), 32)
msg $chan $2's random color is: %color $+ .
}RegEx text pattern
The matchtext parameter can also be a Regular Expression Pattern by using the ’$’ event prefix”).
Example:
on $*:text:/^!test$/i:#:{
msg $chan Test Worked!
}Dynamic text pattern
Text matched patterns can also be dynamic, for example your name at the time of the execution ($me), a variable or time. In order for mIRC to know to evaluate the expression, it must be enclosed by the $() identifier.
Example:
on *:text:$(*slaps $me $+ *):#:{
describe $chan Slaps $nick with dried-up sandwich!
}Or
on *:text:$(!example * $+ %match $+ *):#:{
describe $chan This is an example, $+ $nick $+ !
}If the entire match text pattern contains a SINGLE variable, the $() is not required, this technique can also be used for any other parameter of an event.
Example:
;Assume %text is set to !cool
on *:text:%text:#:{
msg $chan I am the coolest!
}It is also possible to use regular expressions with dynamic match text.
on $*:text:$(/^!slaps $me $+ /Si):#:{
describe $chan Slaps $nick with dried-up sandwich!
}Target
The target parameter of the event defines the locations of where the event can be triggered from. For example, the on text event can be triggered by a channel message or by a query.
- ? - defines query location
-
- defines channel location
- * - defines both query and channel locations
- %var - A variable containing a channel or a list of channels is also acceptable
Example:
;let %chan equal #mSL,#help,#supprt
on *:text:!hi:%chan:{
notice $nick Hello!
}Local $identifier available in the on text event
The on text event support the common IRC related local identifiers
See also
mIRC on event list
| A on Action, on Active, on Agent”), on Appactive B on Ban C on Chat, on Chatclose”), on Chatopen”), on Close, on Connect, on Connectfail, on Ctcpreply D on Dccserver, on Dehelp, on Deop, on Deowner, on Devoice, on Dialog, on Disconnect, on Dns E on Error, on Exit F on Filercvd, on Filesent G on Getfail | H on Help, on Hotlink I on Input, on Invite J on Join K on Keydown, on Keyup, on Kick L on Load, on Logon M on Me, on Midiend, on Mode, on Mp3end N on Nick, on Nosound, on Notice, on Notify O on Op, on Open, on Owner P on Part, on Ping, on Playend, on Pong | Q on Queryclose”), on Queryopen”), on Quit R on Rawmode S on Sendfail, on Serv, on Servclose”), on Servermode, on Serverop, on Servopen”), on Signal”), on Snotice, on Sockclose”), on Socklisten, on Sockopen, on Sockread, on Sockwrite, on Start T on Text, on Topic U on Udpread, on Udpwrite, on Unban, on Unload, on Unotify, on Usermode | V on Vcmd, on Voice W on Wallops, on Waveend |