FLfile.listFolder()

Availability

Flash MX 2004 7.2.

Usage

FLfile.listFolder(folderURI [, filesOrDirectories])

Parameters

folderURI A string, expressed as a file:/// URI, specifying the folder whose contents you want to retrieve. You can include a wildcard mask as part of folderURI. Valid wildcards are * (matches one or more characters) and ? (matches a single character).

filesOrDirectories An optional string that specifies whether to return only filenames or only folder (directory) names. If omitted, both filenames and folder names are returned. Acceptable values are "files" and "directories".

Returns

An array of strings representing the contents of the folder, or false if the folder doesn't exist.

Description

Method; returns an array of strings that represent the contents of the folder, or an empty array if the folder doesn't exist.

Examples

The following example returns an array representing the files, folders, or both files and folders in the Program Files directory:

var folderURI = "file:///C|/WINDOWS/Program Files" ;
var fileList = FLfile.listFolder(folderURI, "files") // files
var fileList = FLfile.listFolder("folderURI", "directories") //folders
var fileList = FLfile.listFolder(folderURI) //files and folders

The following example returns an array of all the text (.txt) files in the temp folder and displays the list in an alert box:

var folderURI = "file:///c|/temp";
var fileMask = "*.txt";
var list = FLfile.listFolder(folderURI + "/" + fileMask, "files");
if (list) {
    alert(folderURI + " contains: " + list.join(" "));
}

The following example uses a file mask in the specified folderURI to return the names of all the executable files in the Windows application folder:

var executables = FLfile.listFolder("file:///C|/WINDOWS/*.exe","files")
alert(executables.join("\n"))