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

Line 1: Line 1:
 
{{mIRC Guide}}
 
{{mIRC Guide}}
The '''ON GETFAIL''' event triggers whenever a remote user sends a file via [[Dcc - mIRC|DCC]] and it fails.
+
The '''ON GETFAIL''' event triggers whenever a remote user sends a file via {{mIRC|/dcc|DCC send]] and it fails.
 
 
This event fills {{mIRC|$filename}}, {{mIRC|$address}}, and {{mIRC|$nick}} with the filename, user's address, and the user's nickname (if available), respectively.
 
  
 
== Synopsis ==
 
== Synopsis ==
Line 8: Line 6:
  
 
== Parameters ==
 
== Parameters ==
<span style="display: inline-block; width: 155px;">'''<level>'''</span>The level for the event to trigger.
+
* '''<level>''' - The corresponding {{mIRC|access levels}} for the event to trigger.
 +
 
 +
* '''<filename>''' - The filename(s) that should match the received file. Seperate multiple values by commas. These can be {{mIRC|wildcard|wildcards}}. Example: ''*.txt,*.doc,my*.txt''
 +
 
 +
* '''<commands>''' - The commands to be performed when the event listener's criteria is met.
 +
 
 +
== {{mIRC|local identifiers}} ==
  
<span style="display: inline-block; width: 155px;">'''<filename[,filename]>'''</span>The filename(s) that should match the failed file. These can be [[wildcard|wildcards]]. Example: ''*.txt,*.doc,my*.txt''
+
=== {{mIRC|$filename}} ===
  
<span style="display: inline-block; width: 155px;">'''<commands>'''</span>The commands to be performed when the event listener's criteria is met.
+
Returns the complete filename of the received file.
  
 
== Examples ==
 
== Examples ==

Revision as of 08:27, 11 February 2016

Template:mIRC Guide The ON GETFAIL event triggers whenever a remote user sends a file via {{mIRC|/dcc|DCC send]] and it fails.

Synopsis

ON <level>:GETFAIL:<filename[,filename]>:<commands>

Parameters

  • <level> - The corresponding access levels for the event to trigger.
  • <filename> - The filename(s) that should match the received file. Seperate multiple values by commas. These can be wildcards. Example: *.txt,*.doc,my*.txt
  • <commands> - The commands to be performed when the event listener's criteria is met.

local identifiers

$filename

Returns the complete filename of the received file.

Examples

Echo the name of the filename, along with both the user's nickname and address if available:

ON *:GETFAIL:*:echo -a Failed to receive $filename $iif($nick,from $nick - ,from) Address: $address

Compatibility

Added: mIRC v5.0
Added on: 02 Apr 1997
Note: Unless otherwise stated, this was the date of original functionality.
Further enhancements may have been made in later versions.


See Also