System.SysUtils.TSearchRec
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.