CFLib.org – Common Function Library Project

fileSize(filename)

Last updated July 11, 2006

author

Jesse Houwing

Version: 3 | Requires: CF5 | Library: FileSysLib

Description:
This function will return the length of a file. It uses the standard Java File object, which makes it very fast under ColdfusionMX. If a directory is passed instead of a file, the UDF will return the total size of all files in the directory. If the file or folder does not exist, it will return 0.

Return Values:
Returns a number.

Example:

<cfset filename="c:\autoexec.bat">
<cfoutput>
    Length: #fileSize(filename)#<br>
</cfoutput>

Parameters:

Name Description Required
filename The filename or directory path. Yes

Full UDF Source:

/**
 * This function will return the length of a file or a directory.
 * Version 2 by Nathan Dintenfass
 * Version 3 by Nat Papovich
 * 
 * @param filename      The filename or directory path. (Required)
 * @return Returns a number. 
 * @author Jesse Houwing (j.houwing@student.utwente.nl) 
 * @version 3, July 11, 2006 
 */
function fileSize(pathToFile) {
    var fileInstance = createObject("java","java.io.File").init(toString(arguments.pathToFile));
    var fileList = "";
    var ii = 0;
    var totalSize = 0;

    //if this is a simple file, just return it's length
    if(fileInstance.isFile()){
        return fileInstance.length();
    }
    else if(fileInstance.isDirectory()) {
        fileList = fileInstance.listFiles();
        for(ii = 1; ii LTE arrayLen(fileList); ii = ii + 1){
            totalSize = totalSize + fileSize(fileList[ii]);
        }
        return totalSize; 
    }
    else
        return 0;
}

Search CFLib.org


Latest Additions

Raymond Camden added
QueryDeleteRows
November 04, 2017

Leigh added
nullPad
May 11, 2016

Raymond Camden added
stripHTML
May 10, 2016

Kevin Cotton added
date2ExcelDate
May 05, 2016

Raymond Camden added
CapFirst
April 25, 2016

Created by Raymond Camden / Design by Justin Johnson