File and Directory Identifiers

$abook(nick,N)

Returns information about nicknames listed in the address book.

Properties: nick, info, email, website, picture, noteN

Allowed formats: $abook(nick) $abook(N) $abook(nick,N) where nick can also be a wildcard.

$alias(N/filename)

Returns the filename for the Nth loaded alias file. If you specify a filename, it returns $null if the file isn't loaded.

$alias(0)

return the number of alias files loaded

$alias(2)

returns the filename of the 2nd loaded alias file

$alias(moo.txt)

returns $null if the file isn't loaded, or moo.txt if it is.

$crc(text|&binvar|filename,[N])

Returns the CRC checksum of the specified item, where N = 0 for plain text, 1 for &binvar, 2 for filename (default).

$disk(path|N)

Returns information about the specified hard disk, where N = 0 for total available drives, and N > 0 to access each drive.

Properties: type, free, label, size, unc, path

$disk(c:) returns $true if drive c: exists, otherwise $false

The unc property returns the path for a network drive.

$exists(file/dir)

Returns $true if a file or dir exists and $false if it doesn't.

$exists(c:\mirc\mirc.exe) returns $true or $false.

$file(filename)

Returns information about the specified file.

Properties: size, ctime, mtime, atime, shortfn, longfn, attr

$file(mirc.exe).size

returns the file size

$file(mirc.exe).ctime

returns creation time

$file(mirc.exe).mtime

returns last modification time

$file(mirc.exe).atime

returns last access time

$filtered

Returns the number of lines that were filtered when using the /filter command.

$finddir(dir,wildcard,N,depth,@window | command)

Searches the specified directory and its subdirectories for the Nth directory name matching the wildcard specification and returns the full path and directory if it is found.

Properties: shortfn

$finddir(c:\,mirc*,1) returns the first directory name beginning with "mirc"

If you specify a custom @window (with a listbox) instead of the N parameter, mIRC will fill the custom @window listbox with the results.

If you specify a command, the command is performed on every directory that is found. You can use $1- to refer to the directory name, eg. //echo 1 $finddir($mircdir,*.*,0,echo $1-)

If you use /halt in the command/alias, this halts the search.

If you specify a depth, mIRC will only search N directories deep for matching filenames.

The $finddirn identifier returns the Nth position of dirrectory that was found.

Note: Both the depth and @window/command parameters are optional.

$findfile(dir,wildcard,N,depth,@window | command)

Searches the specified directory and its subdirectories for the Nth filename matching the wildcard file specification and returns the full path and filename if it is found.

Properties: shortfn

$findfile(c:\mirc,*.exe,1) returns c:\mirc\mirc.exe

If you specify a custom @window name (with a listbox) instead of the N parameter, mIRC will fill the custom @window listbox with the results.

If you specify a command, the command is performed on every filename that is found. You can use $1- to refer to the filename, eg. //echo 1 $findfile($mircdir,*.*,0,echo $1-)

If you use /halt in the command/alias, this halts the search.

If you specify a depth, mIRC will only search N directories deep for matching filenames.

You can specify multiple wildcards by separating them with semi-colons, eg. *.exe;*.txt;*.hlp.

The $findfilen identifier returns the Nth position of file that was found.

Note: Both the depth and @window/command parameters are optional.

$getdir

Returns the DCC Get directory specified in the DCC Options dialog.

$getdir(filespec)

Returns the DCC Get directory for the specified file type.

$getdir(*.txt) returns c:\mirc\text\ (for example)

$ini(file,topic/N,item/N)

Returns the name/Nth position of the specified topic/item in an ini/text file.

$ini(mirc.ini,0) returns total number of topics in mirc.ini

$ini(mirc.ini,1) returns name of 1st topic in mirc.ini

$ini(mirc.ini,help) returns Nth position of topic help if it exists, or returns 0 if it doesn't exist

The item/N parameter is optional. If you specify N = 0, it returns the total number of topics/items.

$isdir(dirname)

Returns $true if the specified directory exists, otherwise $false.

$isfile(filename)

Returns $true if the specified file exists, otherwise $false.

$lines(filename)

Returns the total number of lines in the specified text file.

$lines(c:\irc\kicks.txt) returns the total number of lines in c:\irc\kicks.txt

$logdir

Returns the Logs directory as specified in the Logging section of the Options dialog.

$longfn(filename)

Returns long version of a short filename.

$mididir

Returns the Midi directory specified in the Sound Requests section of the Options dialog.

$mircdir

Returns the current directory of the mIRC program.

$mircexe

Returns the full path and filename of the mIRC exe file.

$mircini

Returns the name of the main .ini file, usually mirc.ini.

$mklogfn(filename)

Returns the filename format that the logging feature uses. Appends date to filename if you have the dated logfiles option turned on in the logging dialog.

You can also use $mknickfn(nickname) to fix a nickname for use as a filename, and $mkfn(filename), which just removes invalid characters.

$msfile(dir,title,oktext)

Displays the multiple select file dialog and returns N, the number of selected files. $msfile(N) returns each file. If too many files are selected, $msfile() returns -1. Title and oktext are optional.

$nofile(filename)

Returns the path in filename without the actual filename.

$nopath(filename)

Returns filename without a path if it has one.

$nopath(c:\mirc\mirc.exe) returns mirc.exe

$read(filename, [ntswrp], [matchtext], [N])

Returns a single line of text from a file.

This identifier works in conjunction with the /write command.

//echo $read(funny.txt)

Reads a random line from the file funny.txt.

//echo $read(funny.txt, 24)

Reads line 24 from the file funny.txt.

//kick # $1 $read(kicks.txt)

Reads a random kick line from kicks.txt and uses it in the kick command.

//echo $read(info.txt, s, mirc)

Scans the file info.txt for a line beginning with the word mirc and returns the text following the match value.

//echo $read(help.txt, w, *help*)

Scans the file help.txt for a line matching the wildcard text *help*. The r switch implies a regex match.

If you specify the s, w, or r switches, you can also specify the N value to specify the line you wish to start searching from in the file, eg.:

//echo $read(versions.txt, w, *mirc*, 100)

If the n switch is specified then the line read in will not be evaluated and will be treated as plain text.

If the p switch is specified, command | separators are treated as such instead of as plain text.

If the first line in the file is a number, it must represent the total number of lines in the file. If you specify N = 0, mIRC returns the value of the first line if it's a number.

If the t switch is specified then mIRC will treat the first line in the file as plain text, even if it is a number.

$readn

Returns the line number that was matched in a previous call to $read(). If no match was found, $readn is set to zero.

$readini(filename, [np], section, item)

Returns a single line of text from an ini file

This identifier works in conjunction with the /writeini command.

//echo $readini(mirc.ini, mIRC, nick)

Reads your nickname from the mirc.ini file.

If the n switch is specified then the line read in will not be evaluated and will be treated as plain text.

If the p switch is specified, command | separators are treated as such instead of as plain text.

$sdir(dir,title)

Displays the select folder dialog and returns the selected folder. Title is optional. The dir can include a wildcard as a dir mask.

$sfile(dir,title,oktext)

Displays the select file dialog and returns the selected filename. Title and oktext are optional. The dir can include a wildcard as a file mask.

$shortfn(filename)

Returns short version of a long filename.