Function Reference

_FileListToArray

Lists files and\or folders in a specified path (Similar to using Dir with the /B Switch)

#include <File.au3>
_FileListToArray($sPath [, $sFilter = "*" [, $iFlag = 0]])

Parameters

$sPath Path to generate filelist for.
$sFilter [optional] the filter to use, default is *. Search the AutoIt3 helpfile for the word "WildCards" For details.
$iFlag [optional] specifies whether to return files folders or both
$iFlag=0(Default) Return both files and folders
$iFlag=1 Return files only
$iFlag=2 Return Folders only

Return Value

Success: an Array, see remarks
Failure: 0
@Error: 1 = Path not found or invalid
2 = Invalid $sFilter
3 = Invalid $iFlag
4 = No File(s) Found

Remarks

The array returned is one-dimensional and is made up as follows:
$array[0] = Number of Files\Folders returned
$array[1] = 1st File\Folder
$array[2] = 2nd File\Folder
$array[3] = 3rd File\Folder
$array[n] = nth File\Folder

Related

Example


#include <File.au3>
#include <Array.au3>

Local $FileList = _FileListToArray(@DesktopDir)
If @error = 1 Then
    MsgBox(0, "", "No Folders Found.")
    Exit
EndIf
If @error = 4 Then
    MsgBox(0, "", "No Files Found.")
    Exit
EndIf
_ArrayDisplay($FileList, "$FileList")