User Guide

cfdirectory 105
The following table shows examples of patterns and file names that they match:
Example
<!--- EXAMPLE 1: Creating and Renaming
Check that the directory exists to avoid getting a
ColdFusion error message. --->
<cfset newDirectory = "otherNewDir">
<cfset currentDirectory = GetDirectoryFromPath(GetTemplatePath()) & "newDir">
<!--- Check to see if the Directory exists. --->
<cfif DirectoryExists(currentDirectory)>
<!--- If TRUE then rename the directory. --->
<cfdirectory action = "rename" directory = "#currentDirectory#" newDirectory
= "#newDirectory#" >
<cfoutput>
<p>The directory existed and the name has been changed to: #newDirectory#</
p>
</cfoutput>
<cfelse>
<!--- If FALSE, create the directory. --->
<cfdirectory action = "create" directory = "#currentDirectory#" >
<cfoutput><p>Your directory has been created.</p></cfoutput>
</cfif>
<!--- EXAMPLE 2: Deleting a directory
Check that the directory exists and that files are not in the directory
to avoid getting ColdFusion error messages. --->
<cfset currentDirectory = GetDirectoryFromPath(GetTemplatePath()) &
"otherNewDir">
<!--- Check to see if the Directory exists. --->
<cfif DirectoryExists(currentDirectory)>
<!--- If TRUE, check to see if there are files in the directory before
deleting. --->
<cfdirectory action="list" directory="#currentDirectory#"
name="myDirectory">
<cfif myDirectory.recordcount gt 0>
<!--- If TRUE, delete the files from the directory. --->
<cfoutput>
<p>Files exist in this directory. Either delete the files or code
something to do so.</P>
</cfoutput>
<cfelse>
<!--- Directory is empty - just delete the directory. --->
<cfdirectory action = "delete" directory = "#currentDirectory#">
<cfoutput>
<p>The directory existed and has been deleted.</P>
</cfoutput>
Pattern Matches
foo.* Any file called foo with any extension; for example, foo.html, foo.cfm, and foo.xml.
*.html All files with the suffix .html, but not files with the suffix .htm.
?? All files with two-character names.