Expandpath - MACROMEDIA COLDFUSION MX 61-CFML Reference

ExpandPath

Description
Creates an absolute, platform-appropriate path that is equivalent to the value of
appended to the base path. This function (despite its name) can accept an absolute or relative
path in the
relative_path
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 syntax
ExpandPath(relative_path)
See also
FileExists, GetCurrentTemplatePath,
History
ColdFusion MX: Changed behavior for the
accept an absolute or relative path in the
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
Parameter
relative_path
Usage
If the parameter or the returned path is invalid, the function throws an error.
These examples show the valid constructions of relative_path:
•
ExpandPath( "*.*")
•
ExpandPath( "/")
•
ExpandPath( "\")
•
ExpandPath( "/mycfpage.cfm")
•
ExpandPath( "mycfpage.cfm")
•
ExpandPath( "myDir/mycfpage.cfm")
•
ExpandPath( "/myDir/mycfpage.cfm")
•
ExpandPath( "../../mycfpage.cfm")
Example
<h3>ExpandPath Example - View Only</h3>
<!---
<cfset thisPath=ExpandPath("*.*")>
<cfset thisDirectory=GetDirectoryFromPath(thisPath)>
<cfoutput>
470 Chapter 3: ColdFusion Functions
attribute
Description
Relative or absolute directory reference or file name, within the current directory,
(.\ and ..\) to convert to an absolute path. Can include forward backward slashes.
GetFileFromPath
attribute: this function can now
relative_path
attribute. To resolve a path, this
relative_path
,
relative_path