AutoIt.@ - Hilfe
FileRead
Liest eine bestimmte anzahl an Zeichen aus einer vorher geöffneten Text-Datei.
FileRead ( <handle> $Dateihandle [ , <int> $Anzahl ] ) Parameter
| Parameter | Typ | Standardwert | Beschreibung |
| $Dateihandle | handle (Kennung) | | Der Handle einer Datei, welche mit FileOpen() geöffnet wurde. Alternativ kann man auch den Dateinamen angeben. |
| $Anzahl | integer (Ganzzahl) | | [optional] Die Anzahl der Zeichen die ausgelesen werden sollen. Standardmäßig wird die ganze Datei gelesen. |
Rückgabewert
| Bei Erfolg: |
Gibt die gelesenen Zeichen als String zurück. |
| Bei Fehler: |
Setzt @error auf 1, falls die Datei nicht im Lesemodus geöffnet wurde (FileOpen()) oder andere Fehler. |
| Spezialfall: |
Setzt @error auf -1, falls das Ende der Datei beim Lesen erreicht wurde. |
Bemerkung
Wenn ein Dateiname angegeben wurde und nicht das Handle, wird die Datei beim Funktionsaufruf geöffnet und wieder geschlossen. Für große Dateien ist das wesentlich langsamer als wenn man den Handle angibt.
ANSI und UTF16/UTF8 Text Formate können nicht gelesen werden. Autoit wird automatisch den Typ festlegen.
Eine Datei kann als Binary gelesen werden bei verwendung von FileOpen mit der "Binary" Flagge. Bei dieser Möglichkeit ist die Anzahl in Bytes anzugeben.
In Verbindung stehende Befehle
Beispiel
$file = FileOpen("test.txt", 0)
; Überprüft ob das öffnen der Datei zum lesen funktioniert hat
If $file = -1 Then
MsgBox(0, "Error", "Kann die Datei nicht öffnen.")
Exit
EndIf
; Ließt 1 Zeichen bei jedem Durchlauf solange bis EOF(End of File = Ende der Datei) erreicht wird.
While 1
$Zeichen = FileRead($file, 1)
If @error = -1 Then ExitLoop
MsgBox(0, "Zeichen gelesen:", $Zeichen)
Wend
FileClose($file)