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 */;
Inhaltsverzeichnis
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| function | public | System.SysUtils.pas System.SysUtils.hpp |
System.SysUtils | System.SysUtils |
Beschreibung
Positioniert die Lese-/Schreibposition neu.
Mit FileSeek können Sie die Lese-/Schreibposition in einer zuvor mit FileOpen oder FileCreate geöffneten Datei neu positionieren. Handle ist das von FileOpen oder FileCreate zurückgegebene Handle.
Offset gibt die Anzahl der Bytes an, um die der Dateizeiger von Origin an verschoben werden soll. Origin ist ein Code mit drei möglichen Werten, die den Dateianfang, das Dateiende und die aktuelle Dateiposition angeben.
| Origin | Aktion |
|---|---|
|
0 |
Der Dateizeiger wird Offset Bytes nach dem Dateianfang positioniert. |
|
1 |
Der Dateizeiger wird Offset Bytes nach der aktuellen Position positioniert. |
|
2 |
Der Dateizeiger wird Offset Bytes vor dem Dateiende positioniert. |
Bei Erfolg gibt FileSeek die neue Position des Dateizeigers zurück. Schlägt die Funktion fehl, wird -1 zurückgegeben.
Anmerkung: Kombinieren Sie keine Routinen, die mit einem Datei-Handle arbeiten, mit Routinen, die eine Delphi-Dateivariable (normalerweise var F) verwenden. Um den Dateizeiger in einer durch eine Delphi-Dateivariable angegebenen Datei zu positionieren, verwenden Sie stattdessen die Prozedur Seek.
Siehe auch
Codebeispiele