folder.files( )

Home

4D v19.8

folder.files( )


folder.files ( {options} ) -> Result

Parameter	Type	Description
options	Longint	File list options
Result	Collection	Collection of children file objects

Description

The folder.files( ) method returns a collection of File objects contained in the folder.

Note: Aliases or symbolic links are not resolved.

By default, if you omit the options parameter, only the files at the first level of the folder are returned in the collection. You can modify this by passing, in the options parameter, one or more of the following constants:

Constant	Value	Comment
fk recursive	1	The collection contains files or folders of the specified folder and its subfolders.
fk ignore invisible	8	Invisible files or folders are not listed

Returned value

Collection of File objects.

Example 1

You want to know if there are invisible files in the Database folder:

 C_COLLECTION($all;$noInvisible)

 $all:=Folder(fk database folder).files()

 $noInvisible:=Folder(fk database folder).files(fk ignore invisible)

 If($all.length#$noInvisible.length)

    ALERT("Database folder contains hidden files.")

 End if

Example 2

You want to get all files that are not invisible in the Documents folder:

 C_COLLECTION($recursive)

 $recursive:=Folder(fk documents folder).files(fk recursive+fk ignore invisible)