Functions > FileDirDisk >

FileFindNextFile

Obtient le nom de fichier suivant dans la liste d�finie par un handle de recherche.

FileFindNextFile ( search [, flag = 0])

Param�tres

search Le handle de recherche, retourn� par FileFindFirstFile().
flag [optionnel] D�termine si la fonction doit retourner les attributs du fichier dans @extended.
    0 = (par d�faut) utilise @extended pour retourner 1 ou 0 si l'�l�ment trouv� est un r�pertoire.
    1 = Retourne une cha�ne dans @extended dans le m�me format que FileGetAttrib().

Valeur de retour

Succ�s: Retourne un nom de fichier en accord avec un pr�c�dent appel � FileFindFirstFile(), et @extended est d�fini selon l'option flag
�chec: Retourne @error = 1 si plus aucun fichier/r�pertoire ne correspond � la recherche.

Remarques

Un pr�c�dent appel � FileFindFirstFile() est n�cessaire pour configurer la recherche et obtenir un handle de recherche. Tous les appels � FileFindNextFile retourneront le fichier suivant trouv� selon la cha�ne de recherche fournie � FileFindFirstFile(). Lorsque @error = 1, plus aucun fichier ne correspond au handle de recherche d'origine.

Lorsque vous avez termin� la recherche avec les fonctions FileFind..., vous devez utiliser FileClose() pour lib�rer le handle de recherche.

En raison de l'API Windows sous-jacente utilis� (FindFirstFile), cette fonction cherche actuellement � la fois les noms de fichier courts et longs. Si vous obtenez des r�sultats inattendus, v�rifiez que ce ne sont pas des noms de fichiers courts qui r�alisent la correspondance.

En relation

FileClose, FileFindFirstFile

Exemple

#include <MsgBoxConstants.au3>

Example()

Func Example()
    ; Assigne une variable locale avec le handle de recherche de tous les fichiers dans le r�pertoire courant.
    Local $hSearch = FileFindFirstFile("*.*")

    ; V�rifie si la recherche a r�ussie, sinon affiche un message et retourne Faux.
    If $hSearch = -1 Then
        MsgBox($MB_SYSTEMMODAL, "", "Erreur: aucun fichier/r�pertoire ne correspond au motif de la recherche .")
        Return False
    EndIf

    ; D�clare une variable locale qui contiendra les noms de fichiers trouv�s.
    Local $iResult = $IDOK, $sFileName = FileFindNextFile($hSearch) ; premier fichier

    While @error = 0 And $iResult = $IDOK
        ; Affiche le nom du fichier.
        $iResult = MsgBox(BitOR($MB_SYSTEMMODAL, $MB_OKCANCEL), "", "Fichier: " & $sFileName)
        ; Si l'utilisateur clique sur le bouton Cancel/Close, la boucle s'arr�te.

        $sFileName = FileFindNextFile($hSearch) ; fichier suivant
    WEnd

    ; Ferme Le handle de recherche.
    FileClose($hSearch)
EndFunc   ;==>Example