CFLib.org – FileCopy

FileCopy(source, destination [, mode] [, attributes])

Last updated September 18, 2007

author

Raymond Camden
Send Email

Version: 1 | Requires: ColdFusion MX | Library: CFMLLib

Rated 0 time(s). Average Rating: 0

Description:
Mimics the cffile, action="copy" command. Please note that this function will not work in ColdFusion 8 as it is a built in function.

Return Values:
Does not return a value.

Example:

<cfscript>
//fileCopy("c:\neotestingzone\udf\cfml\foo.txt","c:\neotestingzone\udf\cfml\foo2.txt");
</cfscript>

Parameters:

Name	Description	Required
source	Source file to copy.	Yes
destination	Path to copy file to.	Yes
mode	Defines permissions for a file on non-Windows systems.	No
attributes	File attributes.	No

Full UDF Source:

	
	<!---
 Mimics the cffile, action=&quot;copy&quot; command.
 Will not work in CF8.
 
 @param source      Source file to copy. (Required)
 @param destination      Path to copy file to. (Required)
 @param mode      Defines permissions for a file on non-Windows systems. (Optional)
 @param attributes      File attributes. (Optional)
 @return Does not return a value. 
 @author Raymond Camden (ray@camdenfamily.com) 
 @version 1, September 18, 2007 
--->
<cffunction name="fileCopy" output="false" returnType="void">
    <cfargument name="source" type="string" required="true">
    <cfargument name="destination" type="string" required="true">
    <cfargument name="mode" type="string" default="" required="false">
    <cfargument name="attributes" type="string" default="" required="false">
    <cfif len(mode)>
        <cffile action="copy" source="#source#" destination="#destination#" mode="#mode#">
    <cfelse>
        <cffile action="copy" source="#source#" destination="#destination#" attributes="#attributes#">
    </cfif>
</cffunction>