$file Identifier - mIRC

$file can be used in two ways:

$file(filename).prop return information about a specified file. If no .property is specified, the size in bytes will be returned by default.

$file="title" dir this is an old syntax, display the select file dialog, this has been replaced by $sfile

Synopsis

$file(filename).prop

$file="title" dir

Parameters

filename - The filename or directory to any local or networked resource, optionally including absolute or relative path (relative to $mircdir)
title - the title of the dialog, the quote are optional if you don't use space, this parameter is optional: //echo -a $file c:\*.txt
dir - the directory you want to display, you can put a file at the end which will be used to fill the 'filename' field in the dialog

Properties

When new $file(filename) is used, you can use the following properties:

.size - Returns the file's size in bytes. (default) (see: $bytes)
.ctime - Returns the file's creation time. (see: $asctime)
.mtime - Returns the file's modification time. (see: $asctime)
.atime - Returns the file's last access time. (see: $asctime)
.shortfn - Returns the file's short filename (if it has one).
.longfn - Returns the file's long filename.
.attr - Returns the file's attributes.
.sig - Checks digital signature of an executable/DLL file. (Returns: ok, fail, none)
.ext - Returns the extention of the filename if a filename is used, $null otherwise
.path - if a folder is passed, returns the path containing that folder ($file(C:\windows\).path is C:\), if a filename is used, returns the path containing the filename.
.name - Returns the name of the folder if a folder is used, or the name of the file without the extention if a filename is used
.version - Returns the file's file version if executable/DLL.
.product - Returns the file's product version if executable/DLL.
.flags - Returns the file's file flags if executable/DLL, the value is a combination bitmask that specifies the compile time attributes of the file:
- 1: DEBUG - The file contains debugging information or is compiled with debugging features enabled.
- 2: PRERELEASE - The file is a development version, not a commercially released product.
- 4: PATCHED - The file has been modified and is not identical to the original shipping file of the same version number.
- 8: PRIVATEBUILD - The file was not built using standard release procedures.
- 16: INFOINFERRED - The file's version structure was created dynamically; therefore, some of the members in this structure may be empty or incorrect.
- 32: SPECIALBUILD - The file was built by the original company using standard release procedures but is a variation of the normal file of the same version number.
- See: https://msdn.microsoft.com/en-us/library/windows/desktop/ms646997(v=vs.85).aspx for more informations.

Example

Tells you some information about mIRC's executable.

//echo -a $mircexe is $bytes($file($mircexe),3).suf and was installed on $asctime($file($mircexe).ctime)

Some more information about mIRC's executable.

//echo -a My copy of mIRC appears to be $iif($file($mircexe).sig == ok,valid.,hacked!)

Compatibility

Added: mIRC v5.71
Added on: 07 May 2000
Note: Unless otherwise stated, this was the date of original functionality.
Further enhancements may have been made in later versions.