@FINDFIRST[[Bereich...] Dateiname[,[+|-]rhsadecijopt]] : Gibt den Namen der ersten passenden Datei zurück Dateinamen, was beinhalten kann Platzhalter und / oder ein Liste einschließen, und welche Datei die im optionalen angegebenen Eigenschaften hat Angebot und Attribut Parameter.
Dateiname muss in Anführungszeichen stehen, wenn es Leerzeichen oder Sonderzeichen enthält.
If Dateinamen in Anführungszeichen gesetzt ist, wird der zurückgegebene Dateiname ebenfalls in Anführungszeichen gesetzt (falls erforderlich).
Die Angebot und Attributparameter, sofern enthalten, definieren Eigenschaften der Dateien, die in die Suche einbezogen werden, wie in angegeben Dateiauswahl Mehrere Angebot Parameter können enthalten sein, jedoch jeweils nicht mehr als einer Größe, Datum, Zeit und Dateiausschluss. Abdeckung Parameter müssen vorangestellt sein Dateinamen. Jeder Angebot Parameter hat die Form
/[a ...]
woher a eines von d, s, t, und / oder !, gefolgt von den Bereichsparametern.
Auf einem LFN-Laufwerk ist das ist zurückgekommen Der Dateiname kann Leerzeichen oder andere Sonderzeichen enthalten. nicht wie @EXPANDIEREN[], werden von dieser Funktion keine doppelten Anführungszeichen hinzugefügt. Um Probleme zu vermeiden, die durch diese Zeichen verursacht werden könnten, zitieren Sie den zurückgegebenen Namen, bevor Sie ihn an andere Befehle übergeben. Siehe die Hinweise unten Variable Funktionen für weitere Details.
@FINDFIRST[] findet die zuerst Datei, die den Anforderungen entspricht. Um weitere passende Dateien zu finden, müssen Sie verwenden @NÄCHSTES FINDEN[], und beenden Sie die Suche mit @FINDCLOSE[].
Warnung: @FINDFIRST Suchen dürfen nicht verschachtelt sein!
Beispiele:
%@findfirst[/[d-30] *]
Suchen Sie nach Dateien, die vor nicht mehr als 30 Tagen erstellt wurden
%@findfirst[/[s2k,3k] "%windir\*.exe",a]
Suchen Sie nach Dateien mit der Erweiterung exe, der Archiv Flag gesetzt und mindestens 2,000 Byte, aber nicht mehr als 3,000 Byte lang, im Windows-Verzeichnis.