User Guide

ManualsBrandsMacromedia ManualsOtherCOLDFUSION MX 61-CFML REFERENCE

461

462

463

464

465

466

467

468

469

470

470 Chapter 3: ColdFusion Functions

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 attribute

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.

See also

FileExists, GetCurrentTemplatePath, GetFileFromPath

History

ColdFusion MX: Changed behavior for the relative_path attribute: this function can now

accept an absolute or relative path in the

relative_path attribute. 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:

• 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>

<!---

Parameter Description

relative_path Relative or absolute directory reference or file name, within the current directory,

(.\ and ..\) to convert to an absolute path. Can include forward backward slashes.