CFLib.org – AvailableSpace

AvailableSpace(drvPath)

Last updated July 19, 2001

author

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

Rated 2 time(s). Average Rating: 1.0

Description:
Returns the amount of space (in bytes) available to the ColdFusion server for a specified drive or network share. Because this function uses COM, it is only supported in the Windows version of ColdFusion.

Return Values:
Returns a simple value.

Example:

view plain print about

<CFOUTPUT>
Available Space on C: #AvailableSpace("c")# bytes
</CFOUTPUT>

<CFOUTPUT>
Available Space on C: #AvailableSpace("c")# bytes
</CFOUTPUT>

Parameters:

Name	Description	Required
drvPath	Drive letter (c, c:, c:\) or network share (\\computer\share).	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 the amount of space (in bytes) available to the ColdFusion server for a specified drive or network share. (Windows only)
 * 
 * @param drvPath 	 Drive letter (c, c:, c:\) or network share (\\computer\share). 
 * @return Returns a simple value. 
 * @author Rob Brooks-Bilson (&#114;&#98;&#105;&#108;&#115;&#64;&#97;&#109;&#107;&#111;&#114;&#46;&#99;&#111;&#109;) 
 * @version 1, July 19, 2001 
 */
function AvailableSpace(drvPath)
{
  Var fso  = CreateObject("COM", "Scripting.FileSystemObject");
  Var drive = fso.GetDrive(drvPath);
  Return drive.AvailableSpace;
}
</cfscript>
		<cfscript>
/**
 * Returns the amount of space (in bytes) available to the ColdFusion server for a specified drive or network share. (Windows only)
 * 
 * @param drvPath      Drive letter (c, c:, c:\) or network share (\\computer\share). 
 * @return Returns a simple value. 
 * @author Rob Brooks-Bilson (rbils@amkor.com) 
 * @version 1, July 19, 2001 
 */
function AvailableSpace(drvPath)
{
  Var fso  = CreateObject("COM", "Scripting.FileSystemObject");
  Var drive = fso.GetDrive(drvPath);
  Return drive.AvailableSpace;
}
</cfscript>