UDF > File >


_FileListToArray

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]]] )

Param�tres

$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.

Valeur de retour

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�

Remarques

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.

En relation

_FileListToArrayRec

Exemples

Exemple 1

#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


Exemple 2

#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