Funktionsreferenz

FileFindFirstFile

Gibt einen den angegebenen Suchkriterien entsprechenden Dateinamen zurück.

FileFindFirstFile ( "filename" )

 

Parameter

filename Suchkriterienstring (die Wildcards * und ? werden akzeptiert)

 

Rückgabewert

Erfolg: Gibt ein Such-"Handle" zurück, das für folgende Funktionen FileFindNextFile benutzt werden kann.
Fehler: Gibt -1 zurück, wenn ein Fehler aufgetreten ist. Wenn der Ordner leer ist, wird @error auf 1 gesetzt.

 

Bemerkungen

Die Suche unterscheidet nicht zwischen Groß- und Kleinschreibung.
Wildcards: Im allgemeinen bezeichnet * null oder mehr Zeichen, ? null oder ein Zeichen. Falls das Suchkriterium nur Wildcards enthält (oder "*.*" ist), ist das untere Beispiel für den Rückgabewert hilfreich!

Es kann nur eine Wildcard im Teil des Dateinamens oder der Endung verwendet werden, z. B. a*.b?.
?? scheint die gleiche Funktion wie * zu haben (in der Dokumentation von Microsoft nicht beschrieben).
Wenn eine 3 Zeichen lange Endung verwendet wird, passt jede mit diesen 3 Zeichen beginnende Endung, z.B. passt "test.log_1" bei "*.log". (in der Dokumentation von Microsoft auch nicht beschrieben).

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

Verzeichnisnamen werden entsprechend den eventuell verwendeten Wildcards zurückgegeben.

 

Verwandte Funktionen

FileClose, FileFindNextFile

 

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)