Funktionsreferenz

FileGetPos

Ermittelt die aktuelle Datei-Position.

FileGetPos ( handle )

 

Parameter

handle Ein Handle zu einer Datei, die zuvor mit FileOpen() geöffnet wurde.

 

Rückgabewert

Erfolg: Gibt die Position vom Anfang der Datei zurück (Erster Index ist 0).
Fehler: Gibt 0 zurück und setzt @error.

 

Bemerkungen

Ein Fehler gibt zwar 0 zurück, aber 0 ist ebenso eine gültige Dateiposition, also ist es ratsam @error zu prüfen um Fehler zu ermitteln.

 

Verwandte Funktionen

FileSetPos, FileRead, FileReadLine, FileWrite, FileWriteLine, FileOpen

 

Beispiel


#include <Constants.au3>

Local Const $sFile = "test.txt"
Local $hFile = FileOpen($sFile, 2)

; Prüft, ob zum Schreiben geöffnete Datei OK ist
If $hFile = -1 Then
    MsgBox(0, "Fehler", "Kann Datei nicht öffnen.")
    Exit
EndIf

; Schreibt etwas in die Datei.
FileWriteLine($hFile, "Zeile1")
FileWriteLine($hFile, "Zeile2")
FileWriteLine($hFile, "Zeile3")

; Entleert den Dateipuffer auf die Festplatte.
FileFlush($hFile)

; Prüft Dateiposition und versucht den Inhalt ab der aktuellen Dateiposition zu lesen.
MsgBox(0, "FileGetPos", StringFormat("Position: %d\nDaten:\n%s", FileGetPos($hFile), FileRead($hFile)))

; Setzt nun die Position an den Anfang.
Local $n = FileSetPos($hFile, 0, $FILE_BEGIN)

; Prüft Dateiposition und versucht den Inhalt ab der aktuellen Dateiposition zu lesen.
MsgBox(0, "FileGetPos", StringFormat("Position: %d\nDaten:\n%s", FileGetPos($hFile), FileRead($hFile)))

; Schließt das Handle.
FileClose($hFile)

; Bereinigt die temporäre Datei.
FileDelete($sFile)