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:

/**
 * 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 (j.houwing@student.utwente.nl) 
 * @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();
}