Funktionsreferenz

FileFindNextFile

Gibt einen Dateinamen entsprechend eines früheren Aufrufes von FileFindFirstFile zurück.

FileFindNextFile ( search )

 

Parameter

search Das Suchhandle, wie es von FileFindFirstFile zurückgegeben wurde.

 

Rückgabewert

Erfolg: Gibt einen Dateinamen entsprechend eines früheren Aufrufes von FileFindFirstFile zurück. @extended wird auf 1 gesetzt, falls der Dateiname ein Verzeichnis ist.
Fehler: Setzt @error auf 1, wenn keine weiteren Dateien/Verzeichnisse den Suchkriterien entsprechen.

 

Bemerkungen

Ein vorheriger Aufruf von FileFindFirstFile ist nötig, um das Suchhandle zu bekommen. Jeder folgende Aufruf von FileFindNextFile gibt die jeweils nächste Datei zurück, die den Suchkriterien aus FileFindFirstFile entspricht. Wenn @error = 1 ist, passen keine weiteren Dateien auf die Suche.

Wenn die Suche mit den FileFind...-Funktionen beendet wurden, muss FileClose() aufrufen werden, um das Suchhandle wieder freizugeben.

 

Verwandte Funktionen

FileClose, FileFindFirstFile

 

Beispiel


; Zeigt die Dateinamen aller Dateien im aktuellen Verzeichnis an.
$search = FileFindFirstFile("*.*")  

; Prüfen, ob die Suche erfolgreich war
If $search = -1 Then
    MsgBox(0, "Fehler", "Es wurden keine Dateien/Verzeichnisse gefunden, die zu dem Suchmuster passen")
    Exit
EndIf

While 1
    $file = FileFindNextFile($search)
    If @error Then ExitLoop
   
    MsgBox(4096, "Datei:", $file)
WEnd

; Handle für Suche schliessen
FileClose($search)