GetFileInfo

Description

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

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.

Function syntax

GetFileInfo(path)

History

ColdFusion 8: Added this function.

Parameters

Parameter	Description
path	Absolute on-disk or in-memory path.

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>