CFLib.org – Common Function Library Project

Description:
This will create a new file, only if a file with the given name does not exist. Use force=true to overwrite a file that already exists

Return Values:
Returns nothing.

Example:

<!---
<cfset filename="c:\autoexec.bat">
<cfset FileCreate(filename, false)> <!--- probably won't work --->
<cfset FileCreate(filename, true)> <!--- will truncate your autoexec.bat --->
--->

Parameters:

Full UDF Source:

<cfscript>
/**
 * Create a new file.
 * 
 * @param filename 	 Filename to create. (Required)
 * @param force 	 Force creation (will nuke existing file). Defaults to false. (Optional)
 * @return Returns nothing. 
 * @author Jesse Houwing (&#106;&#46;&#104;&#111;&#117;&#119;&#105;&#110;&#103;&#64;&#115;&#116;&#117;&#100;&#101;&#110;&#116;&#46;&#117;&#116;&#119;&#101;&#110;&#116;&#101;&#46;&#110;&#108;) 
 * @version 1, February 20, 2003 
 */
function FileCreate(filename){
	var force = false;
	var daFile = createObject('java', 'java.io.File');
	
	if(arraylen(arguments) gte 2) force = arguments[2];
	daFile.init(JavaCast('string', filename));
	if(force) daFile.delete();
	daFile.createNewFile();
}
</cfscript>