From WikiChip
Difference between revisions of "mirc/identifiers/$file"
< mirc‎ | identifiers

(Added $file identifier)
Line 1: Line 1:
−
$file deprecated old
+
{{mirc title|$file Identifier}}'''$file''' will return information about a specified file.  If no .property is specified, the size in bytes will be returned by default.
  
−
YOU LYING LIAR!
+
 
 +
== Synopsis ==
 +
<pre>$file(filename)[.property]</pre>
 +
 
 +
== Parameters ==
 +
<span style="display: inline-block; width: 75px;">'''filename'''</span>The filename or directory to any local or networked resource, optionally including absolute or relative path (relative to [[$scriptdir]]).
 +
 
 +
== Properties ==
 +
{| class="wikitable" style="margin-left: 75px;"
 +
|-
 +
! Property !! Description
 +
|-
 +
| '''.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)
 +
|-
 +
| '''.version''' || Returns the file's ''file version'' if executable/DLL.
 +
|-
 +
| '''.product''' || Returns the file's ''product version'' if executable/DLL.
 +
|- style="vertical-align:top;"
 +
| '''.flags''' || Returns the file's ''file flags'' if executable/DLL, as explained below.
 +
The value will be 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
 +
|}
 +
 
 +
== Example ==
 +
'''Tells you some information about mIRC's executable.'''
 +
<source lang="mIRC">//echo -a $mircexe is $bytes($file($mircexe),3).suf and was installed on $asctime($file($mircexe).ctime)</source>
 +
 
 +
'''Some more information about mIRC's executable.'''
 +
<source lang="mIRC">//echo -a My copy of mIRC appears to be $iif($file($mircexe).sig == ok,valid.,hacked!)</source>
 +
 
 +
== Compatibility ==
 +
{{mIRC compatibility|5.71}}
 +
 
 +
== See Also ==
 +
{{mIRC|File Handling}}
 +
{{mIRC identifier list}}
 +
 
 +
[[Category:mIRC identifiers|file]]

Revision as of 16:03, 27 September 2017

Commands & Identifiers
Basics
Events
Matching Tools
Data Storage
Control Structures
GUI Scripting
Sockets
Advanced Scripting
Additional Resources
Security
Other
v · d · e

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


Synopsis

$file(filename)[.property]

Parameters

filenameThe filename or directory to any local or networked resource, optionally including absolute or relative path (relative to $scriptdir).

Properties

Property Description
.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)
.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, as explained below. 
The value will be 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

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

File Handling

[Expand]
v · d · e mIRC identifier list
Retrieved from "https://en.wikichip.org/w/index.php?title=mirc/identifiers/$file&oldid=65443"