System.SysUtils.FileSeek

De RAD Studio API Documentation
Aller à : navigation, rechercher

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.

Voir aussi