CFLib.org – FileCopy

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

Last updated September 18, 2007

author

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

Rated 1 time(s). Average Rating: 3.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:

view plain print about

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

<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:

	
	
			
			
			
				
				view plain
				
				
				copy to clipboard
				
				
				
				
				print
				
				
				about
				ColdFISH is developed by Jason Delmore.  Source code and license information available at coldfish.riaforge.org.  Version 3.1.1
				
			<!---
 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 (&#114;&#97;&#121;&#64;&#99;&#97;&#109;&#100;&#101;&#110;&#102;&#97;&#109;&#105;&#108;&#121;&#46;&#99;&#111;&#109;) 
 @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>
		<!---
 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>