FsiSeek

obj -> FsiSeek([int1]) : int

Dateizeigerposition ermitteln/setzen

Details

• obj: Datei-Deskriptor
• int1: Neue Dateizeiger-Position (optional)
• Resultat: int Aktuelle Dateizeigerposition
• Siehe: Verwandte Befehle , FsiSeek64 () , FsiRead () , FsiWrite ()

Diese Funktion dient zur Abfrage (ein Argument) oder zum Setzen (zwei Argumente) des Dateizeigers in der externen Datei (obj). Ab dieser Position wird anschließend gelesen (siehe FsiRead ()) oder geschrieben (siehe FsiWrite ()). Die Positionsangabe erfolgt in Bytes - das erste Byte einer Datei steht an Position 0. FsiSeek() kann nicht bei Dateien benutzt werden, die mit der Option _FsiBuffer bei FsiOpen () geöffnet wurden.

Im Resultat wird die angegebene Position zurückgegeben.

info

Ab einer Dateigröße von 2 GB muss der Befehl FsiSeek64 () verwendet werden.

Mit dem Befehl FsiSeek() kann der Dateizeiger auch hinter das Ende einer Datei positioniert werden. Bei einem anschließenden FsiWrite () wird die Datei auf die entsprechende Größe vergrößert. Dies kann ebenfalls mit dem Befehl FsiSize () erfolgen.

Beispiel:

// Dateizeiger an Dateianfang setzen
tHandle->FsiSeek(0);

Mögliche Laufzeitfehler:

• _ErrHdlInvalid: Der Datei-Deskriptor (obj) ungültig