FileExists

Description

Determines whether an on-disk or in-memory file exists.

Returns

Yes, if the file specified in the parameter exists; No, otherwise.

Category

System functions, Decision functions

Function syntax

FileExists(absolute_path)

See also

DirectoryExists, ExpandPath, GetTemplatePath

Parameters

Parameter

Description

absolute_path

The absolute path of the on-disk or in-memory file.

Usage

To access a file on a remote system, the account (for Windows) or user (for UNIX and Linux) that is running ColdFusion must have permission to access the file, directory, and remote system. For example, if you run ColdFusion in the Server Configuration as a Windows service, by default it runs under the local system account, which does not have sufficient privileges to access remote systems. You can change this, however, on the Log On page of the Services Properties dialog box.

Example

<h3>FileExists Example</h3> 
 
<cfset thisPath = ExpandPath("*.*")> 
<cfset thisDirectory = GetDirectoryFromPath(thisPath)> 
<cfoutput> 
The current directory is: #GetDirectoryFromPath(thisPath)# 
<cfif IsDefined("FORM.yourFile")> 
<cfif FORM.yourFile is not ""> 
<cfset yourFile = FORM.yourFile> 
    <cfif FileExists(ExpandPath(yourfile))> 
    <p>Your file exists in this directory. You entered 
    the correct filename, #GetFileFromPath("#thisPath#/#yourfile#")#</p> 
    <cfelse>