Topics   All   Mac OS X (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server   Client   Old   Guides   Examples
New in version: 8.0   8.1   8.2   8.3   8.4   8.5   9.0   9.1   9.2   9.3    Statistic  


Queries list of paths in folder.

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
Files 4.1 Yes Yes Yes Yes Yes
MBS( "Files.ListRecursive"; Path { ; filter; Timeout } )   More


Parameter Description Example value
Path Native path to the directory. "C:\Test\"
filter Optional
Optional, limits what is returned. Default is 0 to report all files. Pass a combination of 1 for showing only files, 2 for showing only directories and 4 for showing only visible files. Add 16 to include package file content on Mac. Add 32 to treat packages as files.
In v7.3 you can add 64 to not list content of invisible directories.
Timeout Optional
the timeout in seconds. Default is 5.


Returns list of files separated by return.


Queries list of paths in folder.
This function is recursive and will look in all subfolders. Due to very large file systems you can pass a timeout. Default is 5 seconds. FileMaker will not respond to user input while the query runs.
The list of names is separated by new line character.
This function needs a native path. Please use Path.FileMakerPathToNativePath function in order to convert a FileMaker style path to a native path.
You can decide on Mac on whether files inside a package (e.g. application) are listed or not. By default we ignore those files, but you can include package content with adding 16 to the filter parameter.

See also Files.List.

If input path ends with / on Windows, we use slash for adding path components in v8.4 or newer. Otherwise we use the default on Windows, which is a backslash.


Queries files in Users folder on Mac:

$files = MBS("Files.List"; "/Users")

Queries visible files in windows folder:

$files = MBS("Files.List"; "c:\Windows\"; 5)

Queries visible files in windows folder, limit for 10 seconds:

$files = MBS("Files.List"; "c:\Windows\"; 5; 10)

List only visible files in visible directories:

MBS( "Files.ListRecursive"; "/Users/shared"; 64+4)

See also

Example Databases

Blog Entries

Created 18th August 2014, last changed 18th September 2018

Files.List   -   Files.ListVolumes

Feedback: Report problem or ask question.

MBS Xojo Chart Plugins