Afficher : Delphi C++
Préférences d'affichage

System.SysUtils.FindFirst

De RAD Studio API Documentation

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

faInvalid

Identifie un fichier non valide.

faReadOnly

Identifie des fichiers ou des répertoires en lecture seule.

faHidden

Identifie des fichiers ou des répertoires cachés.

faSysFile

Identifie des fichiers ou des répertoires système.

faVolumeID

Obsolète

faDirectory

Identifie un répertoire.

faArchive

Identifie des fichier archive Windows.

faNormal

Identifies des fichiers normaux.

faTemporary

Identifies des fichiers ou des répertoires temporaires.

faSymLink

Spécifie seulement des types de fichiers de liaison symboliques.

faCompressed

Identifie un fichier ou un répertoire compressé.

faEncrypted

Identifie un fichier ou un répertoire chiffré.

faVirtual

Réservé pour l'utilisation système.

faAnyFile

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.

Voir aussi

Exemples de code

Outils personnels
Traductions