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

System.SysUtils.TSearchRec

De RAD Studio API Documentation

Delphi

  TSearchRec = record
  private
    function GetTimeStamp: TDateTime;
  public
{$IFDEF MSWINDOWS}
    Time: Integer platform deprecated;
{$ENDIF MSWINDOWS}
{$IFDEF POSIX}
    Time: time_t platform;
{$ENDIF POSIX}
    Size: Int64;
    Attr: Integer;
    Name: TFileName;
    ExcludeAttr: Integer;
{$IFDEF MSWINDOWS}
    FindHandle: THandle platform;
    FindData: TWin32FindData platform;
{$ENDIF MSWINDOWS}
{$IFDEF POSIX}
    Mode: mode_t platform;
    FindHandle: Pointer platform;
    PathOnly: string platform;
    Pattern: string platform;
{$ENDIF POSIX}
    property TimeStamp: TDateTime read GetTimeStamp;
  end;

C++

struct DECLSPEC_DRECORD TSearchRec
{
private:
    System::TDateTime __fastcall GetTimeStamp();
public:
    int Time _DEPRECATED_ATTRIBUTE0 ;
    __int64 Size;
    int Attr;
    TFileName Name;
    int ExcludeAttr;
    NativeUInt FindHandle;
    _WIN32_FIND_DATAW FindData;
    __property System::TDateTime TimeStamp = {read=GetTimeStamp};
};

Propriétés

Type Visibilité  Source Unité  Parent
record
struct
public
System.SysUtils.pas
System.SysUtils.hpp
System.SysUtils System.SysUtils

Description

TSearchRec définit les informations de fichier recherchées par FindFirst ou FindNext.

Le type TSearchRec définit les informations de fichier recherchées lors d'un appel aux fonctions FindFirst ou FindNext. Si un fichier est trouvé, les champs du paramètre de type TSearchRec sont modifiés pour indiquer le fichier trouvé.

Attr représente les attributs du fichier. Vous devez évaluer Attr en le comparant aux valeurs ou aux constantes suivantes pour déterminer si un attribut de fichier correspond aux propriétés du fichier.

Remarque : Les constantes d'attribut renvoient directement à des attributs de fichier DOS.
Constante Valeur Description

faReadOnly

1

Fichiers en lecture seule

faHidden

2

Fichiers cachés

faSysFile

4

Fichiers système

faVolumeID

8

Fichiers d’identification de volume

faDirectory

16

Fichiers répertoire

faArchive

32

Fichiers archive

faSymLink

64

Lien symbolique

faAnyFile

71

Tous les fichiers


La constante faReadOnly a le même nom que la valeur énumérée définie par le type TFieldAttribute. Si les unités System.SysUtils et Data.DB sont toutes les deux utilisées dans vos fichiers source, vous devez faire disparaître l'ambiguïté en spécifiant l'unité afin de qualifier l'utilisation de faReadOnly. Par exemple, écrivez SysUtils.faReadOnly (Delphi) ou SysUtils::faReadOnly (C++).

Afin de tester un attribut, combinez la valeur du champ Attr avec la constante d'attribut, en utilisant l'opérateur and. Si le fichier dispose de l'attribut, le résultat sera supérieur à 0. Par exemple, si le fichier trouvé est caché, l'évaluation de l'expression suivante donnera true :

(SearchRec.Attr and faHidden) <> 0.

(SearchRec.Attr & faHidden) != 0.

Time contient le marqueur date/heure du fichier. Il peut être converti en valeur TDateTime en utilisant la fonction FileDateToDateTime.

Size contient la taille du fichier, en octets.

Name contient le nom de base du fichier, extension comprise.

FindHandle représente un handle interne utilisé pour suivre l'état de la recherche.

FindData contient des informations complémentaires comme l'heure de création du fichier, l'heure du dernier accès et les noms de fichier longs et courts.

Voir aussi

Exemples de code

Outils personnels
Traductions