$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, deprecated syntax, display the select file dialog,
- 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
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 (or folder)'s attributes. the returned value is a concatenation of letters representing the attributes, it will contain a:
- a - archive flag. Is set during normal file-modifying or dir-creation as an indicator to backup programs the file has changed since the last backup, for use with incremental backups. All backups clear this flag for files they archive.
- d - if it is a directory.
- e - if the file/folder is encrypted
- h - if the file/folder is hidden.
- n - if the file/folder is normal, not indexed.
- r - if the file/folder is in read only mode
- s - if the file/folder is a system file/folder
- t - if the file/folder is a sparse file
- x - if you're archiving (a) but are not allowing the indexing of the file/folder's content
- y - if the file is 'temporary' (includes .zip created by $zip)
- .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.
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.
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.