@FINDFIRST[[range...] filename[,[+|-]rhsadecijopt]] :  Renvoie le nom du premier fichier correspondant à filename, qui peut inclure des caractères génériques et/ou une liste d'inclusion, et qui possède les propriétés spécifiées dans les  paramètres facultatifs range et attribute.

 

Le nom du fichier doit être entre guillemets s'il contient des espaces blancs ou des caractères spéciaux .

 

Si le nom de fichier est entre guillemets, le nom de fichier renvoyé sera également entre guillemets (si nécessaire).

 

Les paramètres d'intervalle et d'attribut, s'ils sont inclus, définissent les propriétés des fichiers qui seront inclus dans la recherche comme spécifié dans Sélection de fichiers Plusieurs  paramètres d'intervalle peuvent être inclus, mais pas plus d'un pour la taille, la date, l'heure et l'exclusion de fichier. Les paramètres de plage doivent précéder le nom du fichier.  Chaque  paramètre d'intervalle se présente sous la forme suivante

 

 /[a...]

 

où a est l'un des éléments suivants :d, s, t et/ou !, suivi des paramètres de plage.

 

Sur un lecteur LFN, le  nom de fichier renvoyé peut contenir des espaces blancs ou d'autres caractères spéciaux. Contrairement à @EXPAND[], cette fonction n'ajoute pas de guillemets. Pour éviter les problèmes qui pourraient être causés par ces caractères, mettez le nom retourné entre guillemets avant de le transmettre à d'autres commandes. Voir les notes sous Fonctions variables pour plus de détails.

 

@FINDFIRST[] localise le premier fichier correspondant aux exigences. Pour trouver d'autres fichiers correspondants, vous devez utiliser @FINDNEXT[], et terminer la recherche avec @FINDCLOSE[].

 

Attention : Lesrecherches@FINDFIRST ne peuvent pas être imbriquées!

 

Exemples :

 

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

 locate files created no more than 30 days ago

 

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

 locate files with the extension exe, the archive flag set, and at least 2,000 bytes but not more than 3,000 bytes long, in the Windows directory.