@FINDFIRST[[Bereich...] filename[,[+|-]rhsadecijopt]] :  Gibt den Namen der ersten Datei zurück, die mit filename übereinstimmt , der Wildcards und/oder eine Include-Liste enthalten kann , und die die in den optionalen  Parametern range und attribute angegebenen Eigenschaften hat .

 

DerDateiname muss in Anführungszeichen stehen, wenn er Leerzeichen oder Sonderzeichen enthält.

 

Wenn filename in Anführungszeichen steht, wird der zurückgegebene Dateiname ebenfalls in Anführungszeichen gesetzt (falls erforderlich).

 

Die  Bereichs- und Attributparameter, falls vorhanden, definieren die Eigenschaften der Dateien, die in die Suche einbezogen werden, wie in Dateiauswahl angegeben . Es können  mehrere  Bereichsparameter einbezogen werden, jedoch nicht mehr als je einer für Größe, Datum, Zeit und Dateiausschluss. Die Bereichsparameter müssen vor dem Dateinamen stehen.  Jeder  Bereichsparameter hat die Form

 

 /[a...]

 

wobei a eines von d, s, t und/oder ! ist , gefolgt von den Bereichsparametern.

 

Auf einem LFN-Laufwerk  kann der zurückgegebene Dateiname Leerzeichen oder andere Sonderzeichen enthalten. Im Gegensatz zu @EXPAND[] werden von dieser Funktion keine doppelten Anführungszeichen hinzugefügt. Um Probleme zu vermeiden, die durch diese Zeichen verursacht werden könnten, sollten Sie den zurückgegebenen Namen in Anführungszeichen setzen, bevor Sie ihn an andere Befehle weitergeben.  Weitere Einzelheiten finden Sie in den Hinweisen unter Variablenfunktionen.

 

@FINDFIRST[] findet die erste Datei, die den Anforderungen entspricht. Um weitere passende Dateien zu finden, müssen Sie @FINDNEXT[] verwenden , und die Suche mit @FINDCLOSE[] beenden.

 

Warnung: DieSuche mit @FINDFIRST darf nicht verschachtelt werden!

 

Beispiele:

 

%@findfirst[/[d-30] *]

 locate files created no more than 30 days ago

 

%@findfirst[/[s2k,3k] "%windir\*.exe",a]

 suchen Sie im Windows-Verzeichnisnach Dateien mit der Endung exe, dem gesetzten Archiv-Flag und einer Länge von mindestens 2.000 Byte, aber nicht mehr als 3.000 Byte.