System.SysUtils.FileSeek
Delphi
function FileSeek(Handle: THandle; Offset, Origin: Integer): Integer;
function FileSeek(Handle: THandle; const Offset: Int64; Origin: Integer): Int64;
C++
extern DELPHI_PACKAGE int __fastcall FileSeek(NativeUInt Handle, int Offset, int Origin)/* overload */;
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| function | public | System.SysUtils.pas System.SysUtils.hpp |
System.SysUtils | System.SysUtils |
Description
Repositionne le point de lecture/écriture.
Utilisez FileSeek pour repositionner le point de lecture/écriture dans un fichier ouvert au préalable avec FileOpen ou FileCreate. Handle représente le handle de fichier renvoyé par FileOpen ou FileCreate.
Offset indique le décalage par rapport à Origin du pointeur de fichier. Origin est un code qui peut avoir trois valeurs possibles, indiquant le début du fichier, la fin du fichier, ou encore la position en cours du pointeur.
| Origine | Action |
|---|---|
|
0 |
Le pointeur de fichier est positionné Offset octets à partir du début de fichier. |
|
1 |
Le pointeur de fichier est positionné Offset octets à partir de sa position en cours. |
|
2 |
Le pointeur de fichier est positionné Offset octets à partir de la fin de fichier. |
Si l'exécution de FileSeek réussit, la nouvelle position du pointeur de fichier est renvoyée ; sinon, la valeur -1 est renvoyée.
Remarque : Vous ne devez pas mélanger les routines qui prennent ou renvoient des handles de fichiers avec celles qui utilisent des variables de fichier du langage Delphi (typiquement vu comme var F). Pour placer le pointeur dans un fichier spécifié par une variable de fichier Delphi, utilisez plutôt la procédure Seek.