getfstat, getflstat
getfstat, getflstat |
Purpose
Synopsis
function getfstat(filename:string|text):integer
function getflstat(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
1. The returned status type may be decoded using the constant mask
SYS_TYP (the types are exclusive). Possible values are:
The access mode may be decoded using the constant mask
SYS_MOD (the access modes are additive). Possible values are:
|
SYS_DIR
|
|
|
SYS_REG
|
|
|
SYS_LNK
|
|
|
SYS_OTH
|
|
SYS_READ
|
|
|
SYS_WRITE
|
|
|
SYS_EXEC
|
2. The 2 versions of this function behave the same except for symbolic links: the first one (
getfstat) reports the properties of the linked file while the second (
getflstat) reports a type
SYS_LNK.
Related topics
Module