System.SysUtils.FindFirst
Delphi
function FindFirst(const Path: string; Attr: Integer; var F: TSearchRec): Integer;
C++
extern DELPHI_PACKAGE int __fastcall FindFirst(const System::UnicodeString Path, int Attr, TSearchRec &F);
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| function | public | System.SysUtils.pas System.SysUtils.hpp |
System.SysUtils | System.SysUtils |
Description
Cherche la première instance d'un nom de fichier avec un ensemble d'attributs précis dans un répertoire spécifié.
FindFirst recherche dans le répertoire spécifié par Path le premier fichier qui correspond au nom de fichier spécifié par Path et aux attributs spécifiés par le paramètre Attr. Le résultat est renvoyé dans le paramètre F. Utilisez les champs de cet enregistrement de recherche pour extraire les informations requises. FindFirst renvoie 0 si un fichier a été localisé avec succès ; sinon, elle renvoie un code d'erreur.
Le paramètre constant Path correspond à un répertoire et un masque de fichier qui peut inclure des caractères génériques. Par exemple, '.\test\*.*' indique tous les fichiers du sous-répertoire test (sur Windows).
Outre les fichiers normaux, le paramètre Attr indique les fichiers spéciaux à prendre en compte. Choisissez parmi les constantes suivantes d'attribut de fichier pour définir le paramètre Attr.
| Constante | Description |
|---|---|
|
Identifie un fichier non valide. | |
|
Identifie des fichiers ou des répertoires en lecture seule. | |
|
Identifie des fichiers ou des répertoires cachés. | |
|
Identifie des fichiers ou des répertoires système. | |
|
Obsolète | |
|
Identifie un répertoire. | |
|
Identifie des fichier archive Windows. | |
|
Identifies des fichiers normaux. | |
|
Identifies des fichiers ou des répertoires temporaires. | |
|
Spécifie seulement des types de fichiers de liaison symboliques. | |
|
Identifie un fichier ou un répertoire compressé. | |
|
Identifie un fichier ou un répertoire chiffré. | |
|
Réservé pour l'utilisation système. | |
|
Spécifie tout type de fichier. |
Vous pouvez combiner les attributs en ajoutant leurs constantes ou valeurs (Delphi) ou par un ou logique (C++). Par exemple, pour rechercher, outre les fichiers normaux, les fichiers accessibles en lecture uniquement ainsi que les fichiers cachés, vous devez transmettre (faReadOnly + faHidden) dans Delphi ou (faReadOnly | faHidden) dans C++ comme valeur du paramètre Attr. Pour inclure uniquement les fichiers normaux, passez zéro pour le paramètre Attr.
Remarque : FindFirst alloue des ressources (mémoire) qui doivent être libérées avec FindClose.
Remarque : Certaines constantes d'attributs de fichiers ne sont pas disponibles sur toutes les plates-formes. Par exemple, faVolumeID et faArchive ne fonctionnent pas sur MAC OS.