FSeek()

Aus Wiki des Deutschsprachige Xbaseentwickler e. V.
Zur Navigation springen Zur Suche springen

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