CFLib.org – Common Function Library Project

Description:
This function will remove any reserved characters from a filename string and replace any spaces with underscores.

Return Values:
Returns a string.

Example:

<cfset newfilename = filterFilename(filename) />

<cfoutput>
#newfilename#
</cfoutput>

Parameters:

Full UDF Source:

<!---
 This function will remove any reserved characters from a filename string and replace any spaces with underscores.
 
 @param filename      Filename. (Required)
 @return Returns a string. 
 @author Jason Sheedy (jason@jmpj.net) 
 @version 1, January 19, 2006 
--->
<cffunction name="filterFilename" access="public" returntype="string" output="false" hint="I remove any special characters from a filename and replace any spaces with underscores.">
    <cfargument name="filename" type="string" required="true" />
    <cfset var filenameRE = "[" & "'" & '"' & "##" & "/\\%&`@~!,:;=<>\+\*\?\[\]\^\$\(\)\{\}\|]" />
    <cfset var newfilename = reReplace(arguments.filename,filenameRE,"","all") />
    <cfset newfilename = replace(newfilename," ","_","all") />
    
    <cfreturn newfilename /> 
</cffunction>