File.Status | Part of File module |
Syntax | File.Status (pathName : string, var size, attribute, fileTime : int)
|
Description | File.Status is used to get assorted information about a file or directory. When the function is called with a specified pathName, it returns the information about the file in the other parameters. The size parameter is the size of the file in bytes. The attribute parameter has its individual bits set as exactly as the attribute parameter in Dir.GetLong subprogram does. See Dir.GetLong for the list of attribute constants. The fileTime is the time of last modification of the file. It is returned as the number of seconds since 00:00:00 GMT 1/1/1970. To convert this to a string, use Time.SecDate.
|
Details | If the File.Status call fails, size, attribute and fileTime are all set to 1. Error.Last will return a non-zero value indicating the reason for the failure. Error.LastMsg will return a string which contains the textual version of the error.
|
Example | This program prints information about the NotePad.exe application in Windows found
at "c:\windows\notepad.exe". (Note on some systems, this will be "c:\winnt\notepade.exe"
const pathName : string := "c:/windows/notepad.exe" var size, attribute, fileTime : int File.Status (pathName, size, attribute, fileTime ) if Error.Last = eNoError then put " Name: ", File.FullPath (pathName) put " Created: ", Time.SecDate (fileTime) put " Size: ", size, " bytes" put "Attributes: " .. if (attribute and ootAttrDir) not= 0 then put "Directory " .. else put "" .. end if if (attribute and ootAttrRead) not= 0 then put "Readable " .. else put "" .. end if if (attribute and ootAttrWrite) not= 0 then put "Writable " .. else put "" .. end if if (attribute and ootAttrExecute) not= 0 then put "Executable", skip else put skip end if else put "Unable to get file information" put "Error: ", Error.LastMsg, skip end if
|
Execute | |
Execute | Another example program is available that uses File.Status to
determine the status of several files and directories.
|
Status | Exported qualified. This means that you can only call the function by calling File.Status, not by calling Status.
|