beautypg.com

Dwfile.listfolder(), Dwfile.read() – Adobe Dreamweaver API Reference CS5 User Manual

Page 15

background image

10

DREAMWEAVER API REFERENCE

The file I/O API

Last updated 8/27/2013

Description
This function gets the size of a specified file.

Arguments
fileURL

The fileURL argument, which is expressed as a file:// URL, is the file for which you are checking the size.

Returns
An integer that represents the actual size, in bytes, of the specified file.

DWfile.listFolder()

Availability
Dreamweaver 2.

Description
This function gets a list of the contents of the specified folder.

Arguments
folderURL, {constraint}

The folderURL argument is the folder for which you want a contents list, which is expressed as a file:// URL, plus
an optional wildcard file mask. Valid wildcards are asterisks (*), which match one or more characters, and question
marks (?), which match a single character.

The constraint argument, if it is supplied, must be either

"files"

(return only files) or

"directories"

(return

only folders). If it is omitted, the function returns files and folders.

Returns
An array of strings that represents the contents of the folder.

Example
The following code gets a list of all the text (TXT) files in the C:/temp folder and displays the list in an alert message:

var folderURL = "file:///c|/temp";

var fileMask = "*.txt";
var list = DWfile.listFolder(folderURL + "/" + fileMask, "files");
if (list){

alert(folderURL + " contains: " + list.join("\n"));

}

DWfile.read()

Availability
Dreamweaver 2.

Description
This function reads the contents of the specified file into a string.