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

m (Bot: Adding a template (template:mIRC on event list))
m (Bot: adding missing title)
 
(11 intermediate revisions by 3 users not shown)
Line 1: Line 1:
The '''ON FILERCVD''' event triggers whenever a file is received successfully via [[Dcc send - mIRC|DCC Send]].
+
{{mirc title|On Filercvd - Events}}
 +
The '''ON FILERCVD''' event triggers whenever a file is received successfully via {{mIRC|/dcc|dcc send}}.
  
This event fills [[$filename identifier - mIRC|$filename]], [[$address identifier - mIRC|$address]], and [[$nick identifier - mIRC|$nick]] with the filename, user's address, and the user's nickname (if available), respectively.
+
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 7: Line 8:
  
 
== 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.
  
<span style="display: inline-block; width: 155px;">'''<filename[,filename]>'''</span>The filename(s) that should match the received file. These can be [[wildcard|wildcards]]. Example: ''*.txt,*.doc,my*.txt''
+
* '''<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''
  
<span style="display: inline-block; width: 155px;">'''<commands>'''</span>The commands to be performed when the event listener's criteria is met.
+
* '''<commands>''' - The commands to be performed when the event listener's criteria is met.
 +
 
 +
== {{mIRC|local identifiers}} ==
 +
 
 +
=== {{mIRC|$filename}} ===
 +
 
 +
Returns the complete filename of the received file.
  
 
== Examples ==
 
== Examples ==
Line 21: Line 28:
  
 
== Compatibility ==
 
== Compatibility ==
Added: mIRC v4.5
+
{{mIRC compatibility|4.5}}
 
 
Added On: 30/06/96
 
  
 
== See Also ==
 
== See Also ==
* [[/dcc command - mIRC|/DCC SEND]]
+
* {{mIRC|/dcc|/dcc send}}
* [[On filesent - mIRC|ON FILESENT]]
+
* {{mIRC|on events/on filesent|on filesent}}
* [[On getfail - mIRC|ON GETFAIL]]
+
* {{mIRC|on events/on filesent|on getfail}}
* [[On sendfail - mIRC|ON SENDFAIL]]
+
* {{mIRC|on events/on filesent|on sendfail}}
 
{{mIRC on event list}}
 
{{mIRC on event list}}
  
[[Category:MIRC on events]]
+
[[Category:mIRC on events|filercvd]]

Latest revision as of 19:16, 15 June 2017

The ON FILERCVD event triggers whenever a file is received successfully via dcc send.

This event fills $filename, $address, and $nick with the filename, user's address, and the user's nickname (if available), respectively.

Synopsis[edit]

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

Parameters[edit]

  • <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[edit]

$filename[edit]

Returns the complete filename of the received file.

Examples[edit]

Echo the name of the filename received to the active window:

ON *:FILERCVD:*:echo -a Received filename: $filename

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

ON *:FILERCVD:*:echo -a Received filename: $filename $iif($nick,from $nick - ,from) Address: $address

Compatibility[edit]

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


See Also[edit]