FSeek()

Allgemeines

fSeek() erlaubt es, innerhalb einer mit fCreate() erstellten, bzw mit fOpen() geöffneten Datei eine bestimmte Position festzulegen, an der die nächste fRead(), fReadStr() oder fWrite() Operation stattfinden wird.

Syntax

fSeek(<nHandle>, <nOffset>, [<nOrigin>]) => nPosition

Parameter

<nHandle> ist der Rückgabewert eines erfolgreichen fCreate() bzw. fOpen() Aufrufs.

<nOffset> gibt als ganzzahliger Wert an, ab welcher Position der nächste Zugriff erfolgen soll. Standardmässig orientiet sich nOffset am Dateibeginn (siehe Parameter <nOrigin>)

<nOrigin> gibt an, auf welchen Ausgangspunkt sich die fSeek()-Operation beziehen soll.

Konstante	Bedeutung
FS_SET	Beginn der Datei (dies ist der Standardwert)
FS_RELATIVE	ausgehend von der aktuellen Position
FS_END	Ende der Datei

Rückgabewert

nPosition gibt die neue Position innerhalb der Datei an, bezogen auf <nOrigin>.

Beispiel

LOCAL nHandle
nHandle := fCreate("demo.txt")
IF nHandle > 0
  cString := "Bad Rappenauer Schwarzbier"
  fWrite(nHandle, cString, Len(cString))
  fSeek(nHandle, 5)
  cRead := Space(5)
  fRead(nHandle, @cRead, Len(cRead))
  ? cRead      => "Rappe"
  fClose(nHandle)
ENDIF

Querverweise

fCreate() fOpen()

benötigte DLLs bzw. Include-Dateien

XppRT1.lib

FileIO.ch

Zuordnung

Low Level Dateifunktionen