Adobe ColdFusion 8

GetFileInfo

Description

Retrieves information about a 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.

Category

System functions

Function syntax

GetFileInfo(path)

See also

FileOpen

History

ColdFusion 8: Added this function.

Parameters

Parameter

Description

path

Absolute path (drive, directory, filename, and extension)

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>