CFLib.org – Common Function Library Project

createUniqueFileName(fullpath)

Last updated July 1, 2008

author

Marc Esher

Version: 3 | Requires: CF5 | Library: FileSysLib

Description:
Pass a full file path to this function; if the file exists, the function will return a new, unique file name.

Return Values:
Returns a string.

Example:

<cfset newFile = CreateUniqueFileName(GetCurrentTemplatePath())>
<cfoutput>Your New File Name: #newFile#</cfoutput>

Parameters:

Name Description Required
fullpath Full path to file. Yes

Full UDF Source:

/**
 * Creates a unique file name; used to prevent overwriting when moving or copying files from one location to another.
 * v2, bug found with dots in path, bug found by joseph
 * v3 - missing dot in extension, bug found by cheesecow
 * 
 * @param fullpath 	 Full path to file. (Required)
 * @return Returns a string. 
 * @author Marc Esher (marc.esher@cablespeed.com) 
 * @version 3, July 1, 2008 
 */
function createUniqueFileName(fullPath){
    var extension = "";
    var thePath = "";
    var newPath = arguments.fullPath;
    var counter = 0;
    
    if(listLen(arguments.fullPath,".") gte 2) extension = listLast(arguments.fullPath,".");
    thePath = listDeleteAt(arguments.fullPath,listLen(arguments.fullPath,"."),".");

    while(fileExists(newPath)){
        counter = counter+1;        
        newPath = thePath & "_" & counter & "." & extension;            
    }
    return newPath;    
}
blog comments powered by Disqus

Search CFLib.org


Latest Additions

Kevin Cotton added
date2ExcelDate
May 5, 2016

Raymond Camden added
CapFirst
April 25, 2016

Chris Wigginton added
loremIpsum
January 18, 2016

Gary Stanton added
calculateArrival...
November 19, 2015

Sebastiaan Naafs - van Dijk added
getDaysInQuarter
November 13, 2015

Created by Raymond Camden / Design by Justin Johnson