Obtient, dans un tableau, les fichiers et/ou les sous-r�pertoires d'un r�pertoire (similaire � la commande Dir /B)
#include <File.au3>
_FileListToArray ( $sFilePath [, $sFilter = "*" [, $iFlag = $FLTA_FILESFOLDERS [, $bReturnPath = False]]] )
$sFilePath | R�pertoire o� se trouvent les �l�ments � r�cup�rer. |
$sFilter | [optionnel] Le filtre � utiliser, par d�faut, *. (Les Jokers * et ? sont accept�s - Voir Remarques) |
$iFlag | [optionnel] Indique s'il faut retourner les fichiers ou les r�pertoires ou les deux $FLTA_FILESFOLDERS (0) = (par d�faut) Retourne les fichiers et les r�pertoires $FLTA_FILES (1) = Retourne uniquement les fichiers $FLTA_FOLDERS (2) = Retourne uniquement les sous-r�pertoires Les constantes sont d�finies dans FileConstants.au3 |
$bReturnPath | [optionnel] Si True, le chemin complet pr�c�de le nom du fichier ou du sous-r�pertoire, sinon il est relatif au dossier $sFilePath. Par d�faut, False. |
Succ�s: | Retourne un tableau de dimension 1. $aArray[0] = Nombre de Fichiers/R�pertoires retourn�s $aArray[1] = 1er Fichier/R�pertoire $aArray[2] = 2e Fichier/R�pertoire $aArray[3] = 3e Fichier/R�pertoire $aArray[n] = n-i�me Fichier/R�pertoire |
�chec: | D�finit @error <> 0. |
@error: | 1 - R�pertoire introuvable ou invalide 2 - $sFilter invalide 3 - $iFlag invalide 4 - Aucun fichier trouv� |
Cette fonction utilise le syst�me d'exploitation Windows pour retourner les sous-dossiers correspondant au filtre sp�cifi�. Cela fonctionne parfaitement pour des filtres simples, l'utilisation de filtre complexe avec plusieurs caract�res g�n�riques peuvent retourner des r�sultats inattendus (par exemple *test*.* trouvera � la fois testX et le sous-r�pertoire testX.X ). Si cela se produit, la fonction _FileListToArrayRec() pourrait �tre mieux, car elle compare tous les sous-r�pertoires pour le filtre sp�cifi� en utilisant une expression r�guli�re, bien que le temps pris pour ex�cuter la fonction risque d'�tre sensiblement plus important.
Voir FileFindFirstFile() pour des d�tails sur les caract�res g�n�riques.
#include <Array.au3> #include <File.au3> #include <MsgBoxConstants.au3> Example() Func Example() ; Liste tous les fichiers et sous-r�pertoires du dossier bureau en utilisant les param�tres par d�faut. Local $aFileList = _FileListToArray(@DesktopDir, "*") If @error = 1 Then MsgBox($MB_SYSTEMMODAL, "", "Le chemin �tait incorrect.") Exit EndIf If @error = 4 Then MsgBox($MB_SYSTEMMODAL, "", "Aucun fichier trouv�.") Exit EndIf ; Affiche les r�sultats retourn�s par _FileListToArray. _ArrayDisplay($aFileList, "$aFileList") EndFunc ;==>Example
#include <Array.au3> #include <File.au3> #include <MsgBoxConstants.au3> Example() Func Example() ; Liste tous les fichiers et sous-r�pertoires du dossier bureau en utilisant les param�tres par d�faut et retourne le chemin complet. Local $aFileList = _FileListToArray(@DesktopDir, Default, Default, True) If @error = 1 Then MsgBox($MB_SYSTEMMODAL, "", "Le chemin �tait incorrect.") Exit EndIf If @error = 4 Then MsgBox($MB_SYSTEMMODAL, "", "Aucun fichier trouv�.") Exit EndIf ; Afficher les r�sultats retourn�s par _FileListToArray. _ArrayDisplay($aFileList, "$aFileList") EndFunc ;==>Example