Revision as of 12:17, 20 January 2020

$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, Note: This feature has essentially 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 (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 is a directory.
  • e - if the file/folder is encrypted
  • h - if the file/folder is hidden.
  • n - if the file/folder is compressed to save disk spaces.
  • r - if the file/folder is in read only mode
  • s - if the file/folder is a system file/folder
  • t - if the folder is an hard link
  • 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.

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.

See Also