ColdFusion 9.0 Resources

FileDelete

Description

Deletes the specified on-disk or in-memory file on the server.

Function syntax

FileDelete(filepath)

History

ColdFusion 8: Added this function.

Parameters

Parameter	Description
`filepath`	Pathname of the on-disk or in-memory file to delete. If not an absolute path (starting with a drive letter and a colon, or a forward or backward slash), it is relative to the ColdFusion temporary directory, which is returned by the `GetTempDirectory` function.

Usage

Use this function to free the memory used by an in-memory file. For more information on using in-memory files, see Optimizing transient files in the Developing ColdFusion Applications.

Example

The following example deletes the file c:\productiondir\test1.txt before moving c:\testdir\test1.txt:

<h3>FileDelete Example</h3> 
 
<cfset sourcefile="c:\testdir\test1.txt"> 
<cfset destinationfile="c:\productiondir\test1.txt"> 
 
<cfif FileExists(#sourcefile#)> 
    <cfif FileExists(#destinationfile#)> 
        <cfoutput>The destination file already exists.<br> 
            Deleting previous copy of #destinationfile#.<br> 
            Moving: #sourcefile# <br> 
            To: <br> #destinationfile#.</cfoutput><br> 
        <cfscript> 
            FileDelete(#destinationfile#); 
            FileMove(#sourcefile#, #destinationfile#); 
        </cfscript> 
    <cfelse> 
        <cfscript> 
            FileMove(#sourcefile#, #destinationfile#); 
        </cfscript> 
        <cfoutput>Moved: #sourcefile# <br> 
            To: <br> #destinationfile#.</cfoutput><br> 
    </cfif> 
<cfelse> 
    <cfoutput>The source file does not exist.</cfoutput><br> 
</cfif>