From WikiChip
Difference between revisions of "mirc/on events/on error"
< mirc‎ | on events

m (Bot: adding missing title)
 
(2 intermediate revisions by one other user not shown)
Line 1: Line 1:
{{mIRC Guide}}
+
{{mirc title|On Error - Events}}
The '''ON ERROR''' event is triggered when an [[Server - IRC|IRC Server]] sends an error message, most-likely a disconnect message.
+
The '''ON ERROR''' event is triggered when an server sends an error message, most-likely a disconnect message.
 
 
This event fills the '''$1-''' identifier with the entire error message.
 
  
 
== Synopsis ==
 
== Synopsis ==
Line 8: Line 6:
  
 
== Parameters ==
 
== Parameters ==
<span style="display: inline-block; width: 105px;">'''<level>'''</span>The level for the event to trigger.
+
* '''<level>''' - The corresponding {{mIRC|access levels}} for the event to trigger.
 +
* '''<matchtext>''' - The corresponding {{mIRC|on text|matchtext}} for the event to trigger.
 +
* '''<commands>''' - The commands to be performed when the event triggers
 +
 
 +
== {{mIRC|local identifiers}} ==
  
<span style="display: inline-block; width: 105px;">'''<matchtext>'''</span>The text that to be matched. Can also be a [[wildcard]].
+
=== {{mIRC|$N|$1-}} ===
  
<span style="display: inline-block; width: 105px;">'''<commands>'''</span>The commands to be performed when the event listener's criteria is met.
+
Returns the error message.
  
 
== Example ==
 
== Example ==

Latest revision as of 20:14, 15 June 2017

The ON ERROR event is triggered when an server sends an error message, most-likely a disconnect message.

Synopsis[edit]

ON <level>:ERROR:<matchtext>:<commands>

Parameters[edit]

  • <level> - The corresponding access levels for the event to trigger.
  • <matchtext> - The corresponding matchtext for the event to trigger.
  • <commands> - The commands to be performed when the event triggers

local identifiers[edit]

$1-[edit]

Returns the error message.

Example[edit]

This example will trigger if the response full is in the server-returned error:

ON *:ERROR:*full*:echo -s This server is most-likely full. Server sent error: $1-

This example triggers if the word ban is within the server error:

ON *:ERROR:*ban*:echo -s You're most-likely banned from this server. Server sent error: $-

Compatibility[edit]

Added: mIRC v4.7
Added on: 09 Dec 1996
Note: Unless otherwise stated, this was the date of original functionality.
Further enhancements may have been made in later versions.


See Also[edit]