Initializing help system before first use

getfstat

getfstat


Purpose
Get the status (type and access mode) of a file or directory.
Synopsis
function getfstat(filename:string|text):integer
Argument
filename 
Name (and path) of the file or directory to check
Return value
Bit encoded type and mode of the given file or 0 if the file cannot be accessed.
Example
The following determines whether ftest is a directory and if it is writable:
fstat:= getfstat("ftest")
if bittest(fstat, SYS_TYP)=SYS_DIR
then writeln("ftest is a directory")
end-if
if bittest(fstat, SYS_WRITE)=SYS_WRITE
then writeln("ftest is writeable")
end-if 
Further information
The returned status type may be decoded using the constant mask SYS_TYP (the types are exclusive). Possible values are:
SYS_DIR 
Directory
SYS_REG 
Regular file
SYS_OTH 
Special file (device, pipe...)
The access mode may be decoded using the constant mask SYS_MOD (the access modes are additive). Possible values are:
SYS_READ 
Can be read
SYS_WRITE 
Can be modified
SYS_EXEC 
Is executable

Module