getFileInfo

Description

Retrieves information about on-disk or in-memory file.

Categories

Related

History

ColdFusion 8: Added this function.

Syntax

GetFileInfo(path)

Attributes

AttributeDescriptionRequiredDefault
pathAbsolute on-disk or in-memory path.

Returns

The filename, path, parent directory, type, size, when the file was most recently modified, whether the file has read permission, write permission, and is hidden.

Usage

The function returns a structure that includes the following keys:
Name: name of the file
Path: absolute path of the file
Parent: path to the file’s parent directory
Type: either "directory" or "file"
Size: file size in bytes
Lastmodified: datetime when it was the file was most recently modified
canRead: whether the file can be read
canWrite: whether the file has write permission
isHidden: whether the file is a hidden

Example

<cfscript> 
    FileSetLastModified("c:\temp\test1.txt", "#Now()#"); 
    WriteOutput(GetFileInfo("c:\temp\test1.txt").lastmodified); 
</cfscript>