Adobe ColdFusion 8

FileCopy

Description

Copies the specified source file to the specified destination file.

Category

System functions

Function syntax

FileCopy(source, destination)

See also

FileClose, FileIsEOF, FileOpen, FileRead, FileReadLine, FileWrite, cffile

History

ColdFusion 8: Added this function.

Parameters

Parameter

Description
source

Pathname of the file to copy. If not an absolute path (starting a 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.
destination

Pathname of a directory or file on the web server where the file is copied. If you specify a filename without a directory path, ColdFusion copies it relative to the source directory.

Example

The following example copies the test1.txt file from the c:\testingdir\ directory to the c:\productiondir\ directory in Windows and names the new copy of the file test2.txt:

<h3>FileCopy Example</h3>
<cfset sourcefile="c:\testingdir\test1.txt">
<cfset destinationfile="c:\productiondir\test2.txt">

<cfif FileExists(#sourcefile#)>
    <cfif FileExists(#destinationfile#)>
        <cfoutput>A copy of #destinationfile# already exists.</cfoutput>
    <cfelse>
        <cfscript>
        FileCopy(#sourcefile#, #destinationfile#);
        </cfscript>
        <cfoutput>Copied: #sourcefile# <br>
            To: #destinationfile#</cfoutput><br>
    </cfif>
<cfelse>
    <cfoutput>The source file does not exist.</cfoutput><br>
</cfif>