Revision as of 17:31, 21 July 2018

The $get identifier can be used to gather various details regarding open DCC Get windows, even if the transfers completed.

Synopsis

$get(N/nick[,N])[.property]

Parameters

N/nick Refers to either the Nth open connection, or the connection associated with a specific user's nickname
[N] If a nickname is specified in the primary parameter, the secondary N targets the Nth connection associated with that nickname match

When N = 0, $get(N) returns the total number of all transfers, and $get($nick,N) returns total transfers from $nick.
$get($nick) used without the 2nd N parameter returns $nick if there is at least 1 $get or $null if no transfers.
When N >=1, $get(N) or $get($nick,N) returns the $nick associated with that transfer.
When sender changes nick, the $get is still associated with the old nick unless you use: /dcc nick -sgcf <oldnick> <newnick>

Note: $get(-1) can be used during the ON FILERCVD and ON GETFAIL events, it refers to the 'get' which triggered that event.

Properties

cid The connection id
cps The characters-per-second transfer rate, averages speed during recent time period until transfer finishes, when rate is averaged across entire connection time
done Returns $true if the transfer has completed, otherwise returns $false
file The file name of the current transfer
hwnd The window handle
idle the number of seconds that the file transfer has been idle
ip The IP Address for the remote user
path The path of the file name being transferred
pc The percentage complete for the transfer
rcvd The total amount of bytes received so far including the resume offset received during a previous get
resume If the transfer has been resumed, returns the location in the file from where the resume took place. Does not offer a way to discern between a transfer not resumed and a transfer resumed at offset zero
secs The total number of seconds the transfer has been connected
size The file size in bytes for the transfer
status The status of the window; returns: active, or inactive
wid The mIRC window id for this window

Example

Echo the total percent completed of the 3rd transfer:

//echo -a $get(3).pc

Echo the total number of transfers:

//echo -a $get(0)

Summary of open DCC Get windows:

//var %i 1 | while ( %i isnum 1- $get(0) ) { echo -a %i nick: $get(%i) file: $get(%i).file size: $get(%i).size status: $get(%i).status | inc %i }

Compatibility

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

See Also

• $chat
• $fserve
• $send