&stat - Retrieve a file statistic
&stat <stat> <filename>
&stat returns the specified <stat> on the given <filename>. Valid <stat> values are:-
a
d
r
s
t
X File does not exist. R File is a regular file. D File is a directory. H File is a http URL link (see note). F File is an ftp URL file (see note). N File is an untouchable system file.
Note that a URL type is determined from the file name, e.g. http://..., and its existence is not verified.
w
x
The following example is a macro which, given a file name, uses &stat to check that file file is regular:
define-macro test-file !force set-variable #l0 @1 !if ¬ $status set-variable #l0 @ml04 "File name" !endif !if ¬ &equ &stat "t" #l4 1 ml-write &spr "[%s is not a regular file]" #l0 !abort !endif !emacro test-file "foobar"
The macro can be passed a file name and aborts if the file is not regular, there by returning the state.
The follow example checks that a file is not empty, this is used by mail-check to test for any incoming mail.
!if &gre &stat "s" %incoming-mail-box ml-write "[You have new mail]" !endif
(c) Copyright JASSPA 2001
Last Modified: 2001/07/14
Generated On: 2001/08/15