CFLib.org – getRelative

getRelative(abspath)

Last updated April 9, 2012

author

Version: 2 | Requires: ColdFusion 5 | Library: FileSysLib

Rated 2 time(s). Average Rating: 4.0

Description:
Use getRelative() is the inverse of the ColdFusion native ExpandPath() function -- it takes an absolute file path and returns a relative path to the given file from the current template. As opposed to expandpath(), getRelative() creates a path relative to the current template, not the base template.

Return Values:
Returns a string.

Example:

view plain print about

<cfoutput>#getRelative('d:\temp\test.txt')#</cfoutput>

<cfoutput>#getRelative('d:\temp\test.txt')#</cfoutput>

Parameters:

Name	Description	Required
abspath	Absolute path.	Yes

Full UDF Source:

	
	
			
			
			
				
				view plain
				
				
				copy to clipboard
				
				
				
				
				print
				
				
				about
				ColdFISH is developed by Jason Delmore.  Source code and license information available at coldfish.riaforge.org.  Version 3.1.1
				
			<cfscript>
/**
 * Returns a relative path from the current template to an absolute file path.
 * v2 fix by Tony Monast
 * 
 * @param abspath 	 Absolute path. (Required)
 * @return Returns a string. 
 * @author Isaac Dealey (&#105;&#110;&#102;&#111;&#64;&#116;&#117;&#114;&#110;&#107;&#101;&#121;&#46;&#116;&#111;) 
 * @version 2, April 9, 2012 
 */
function getRelative(abspath) { 
       var currentPath = ListToArray(GetDirectoryFromPath(GetBaseTemplatePath()),"\/");
       var filePath = ListToArray(abspath,"\/");
       var relativePath = ArrayNew(1);
       var pathStart = 0;
       var i = 0;

       /* Define the starting path (path in common) */
       for (i = 1; i LTE ArrayLen(currentPath); i = i + 1) {

               if (currentPath[i] NEQ filePath[i]) {
                       pathStart = i;
                       break;
               }
       }

       /* Build the prefix for the relative path (../../etc.) */
       for (i = ArrayLen(currentPath) - pathStart ; i GTE 0 ; i = i - 1) {
               ArrayAppend(relativePath,"..");
       }

       /* Build the relative path */
       for (i = pathStart; i LTE ArrayLen(filePath) ; i = i + 1) {
               ArrayAppend(relativePath,filePath[i]);
       }

       /* Return the relative path */
       return ArrayToList(relativePath,"/");
}
</cfscript>
		<cfscript>
/**
 * Returns a relative path from the current template to an absolute file path.
 * v2 fix by Tony Monast
 * 
 * @param abspath      Absolute path. (Required)
 * @return Returns a string. 
 * @author Isaac Dealey (info@turnkey.to) 
 * @version 2, April 9, 2012 
 */
function getRelative(abspath) { 
       var currentPath = ListToArray(GetDirectoryFromPath(GetBaseTemplatePath()),"\/");
       var filePath = ListToArray(abspath,"\/");
       var relativePath = ArrayNew(1);
       var pathStart = 0;
       var i = 0;

       /* Define the starting path (path in common) */
       for (i = 1; i LTE ArrayLen(currentPath); i = i + 1) {

               if (currentPath[i] NEQ filePath[i]) {
                       pathStart = i;
                       break;
               }
       }

       /* Build the prefix for the relative path (../../etc.) */
       for (i = ArrayLen(currentPath) - pathStart ; i GTE 0 ; i = i - 1) {
               ArrayAppend(relativePath,"..");
       }

       /* Build the relative path */
       for (i = pathStart; i LTE ArrayLen(filePath) ; i = i + 1) {
               ArrayAppend(relativePath,filePath[i]);
       }

       /* Return the relative path */
       return ArrayToList(relativePath,"/");
}
</cfscript>