Error getting tags :
error 404Error getting tags :
error 404 folders | revDocs | RunRev
Welcome Guest (Log in)
Product Edition
Expander triangle
the [detailed | long] folders folders()
Desktop, Web and Server
Platform Support
MacOS,Mac OS X,Windows,Linux
Returns a list of the folders in the current defaultFolder.

set the defaultFolder to line x of the folders
put the detailed folders into folderList

Additional Comments
Expander triangle

Use the folders function to obtain a list of folders to display for the user, or to perform an action on each folder in the current folder.


The folders function returns a list of folder names, one per line.

The detailed folders form returns a list of folders, one file per line. Each line contains the following attributes, separated by commas. (Several attributes are used only for compatibility with the files function and do not have any meaning for folders.)

* The folder's name

* The folder's size in bytes (always zero)

* The folder's resource fork size in bytes (always zero)

* The folder's creation date in seconds (Mac OS, OS X, and Windows systems only)

* The folder's modification date in seconds

* The folder's last-accessed date in seconds (Unix and Windows systems only)

* The folder's last-backup date in seconds (Mac OS and OS X systems only)

* The folder's owner (Unix systems only)

* The folder's group owner (Unix systems only)

* The folder's access permissions

* The folder's creator and file type (always "????????") (Mac OS and OS X only)

Any attribute that is not supported on the current system is reported as "0" (zero).

The first line is always "..", representing the folder that contains the current folder.


Files in the defaultFolder are not included. To get a list of folders, use the files function.

The names of aliases (on Mac OS systems), symbolic links (on Unix systems), and shortcuts (on Windows systems) are included in the value returned by the folders if they link to a folder. If they link to a file, they are not included.

This function lists only the folders on the top level of the defaultFolder. To get a list of subfolders within a folder, set the defaultFolder to that folder and then use the folders function again.

When listed in the detailed folders form, each folder's name is URL-encoded. To obtain the name in plain text, use the URLDecode function. If the detailed modifier is not used, the folder name is not encoded.

The access permissions returned in the detailed files form consist of three octal digits. The form is the same as that used for the umask command.

Changes to Revolution:

The detailed folders form was introduced in version 1.1. In previous versions, the folders function provided only a list of folder names.

User Comments
Expander triangle
User thumbnail
Oct 4, 2010
The following is stated above: "The first line is always "..", representing the folder that contains the current folder." On LINUX, the first line is NOT always ".." You might require a sort to get ".." at the top of the list of folders.