| EXPANDPATH | |
| Description
Creates an absolute, platform-appropriate path that is equivalent to the value of relative_path, appended to the base path. This function (despite its name) can accept an absolute or relative path in the relative_path parameter The base path is the currently executing page's directory path. It is stored in pageContext.getServletContext(). |
|
| Returns
A string. If the relative path contains a trailing forward slash or backward slash, the return value contains the same trailing character. |
|
| Category
System functions |
|
Function syntaxExpandPath(relative_path) |
|
| See also
FileExists, GetCurrentTemplatePath, GetFileFromPath |
|
| History
ColdFusion MX: Changed behavior for the relative_path parameter: this function can now accept an absolute or relative path in the relative_path parameter. To resolve a path, this function uses virtual mappings that are defined in the ColdFusion Administrator. This function does not reliably use virtual mappings that are defined in IIS, Apache, or other web servers. |
|
| Parameters
|
|
| Usage
If the parameter or the returned path is invalid, the function throws an error. These examples show the valid constructions of relative_path:
|
|
Example<h3>ExpandPath Example - View Only</h3>
<!---
<cfset thisPath=ExpandPath("*.*")>
<cfset thisDirectory=GetDirectoryFromPath(thisPath)>
<cfoutput>
The current directory is: #GetDirectoryFromPath(thisPath)#
<cfif IsDefined("form.yourFile")>
<cfif form.yourFile is not "">
<cfset yourFile = form.yourFile>
<cfif FileExists(ExpandPath(yourfile))>
<p>Your file exists in this directory. You entered
the correct file name, #GetFileFromPath("#thisPath#/#yourfile#")#
<CFELSE>
<p>Your file was not found in this directory:
<br>Here is a list of the other files in this directory:
<!--- use CFDIRECTORY to give the contents of the
snippets directory, order by name and size --->
<CFDIRECTORY DIRECTORY="#thisDirectory#"
NAME="myDirectory"
SORT="name ASC, size DESC">
<!--- Output the contents of the CFDIRECTORY as a CFTABLE --->
<CFTABLE QUERY="myDirectory">
<CFCOL HEADER="NAME:"
TEXT="#Name#">
<CFCOL HEADER="SIZE:"
TEXT="#Size#">
</CFTABLE>
</cfif>
</cfif>
<cfelse>
<h3>Please enter a file name</h3>
</CFIF>
</cfoutput>
<FORM action="expandpath.cfm" METHOD="post">
<h3>Enter the name of a file in this directory <I>
<FONT SIZE="-1">(try expandpath.cfm)</FONT></I></h3>
<INPUT TYPE="Text" NAME="yourFile">
<INPUT TYPE="Submit" NAME="">
</form>
--->
|
|
| RELATIVE_PATH | |