# Funktionsreferenz

FileWrite

Hängt eine Zeile Text an das Ende einer zuvor geöffneten Datei an.

FileWrite ( filehandle or "filename", "line" )

Parameter

filehandle | Das Handle der Datei, wie es von einem früheren Aufruf von FileOpen zurückgegeben wurde. Alternativ kannst du einen String mit dem Dateinamen als ersten Parameter verwenden.
line | Die Textzeile, die in die Datei geschrieben werden soll. Die zeile wird so wie sie ist in die Datei geschrieben. Es wird kein @CR oder @LF angehängt.

Bemerkungen

Die Textdatei muss im writemode (Schreibmodus) geöffnet sein, damit FileWriteLine keinen Fehler hervorruft.
Wenn ein Dateiname statt eines Dateihandles angegeben wird, wird die Datei wärhrend des Funktionsaufrufes geöffnet und geschlossen. Wenn du große Textdateien bearbeitst, ist das natürlich viel langsamer als die Arbeit mit Handles. Die Datei wird wird erstellt, wenn sie noch nicht existiert.
Hinweis: Vermische nicht die Verwendung von Dateihandles und -namen. Öffne z.B. nicht eine Datei mit FileOpen und verwende dann in dieser Funktion einen Dateinamen. Benutze entweder Handles oder Dateinamen - nicht beides.

Siehe auch

FileClose, FileOpen, FileRead, FileReadLine, FileWriteLine

Beispiel

$file = FileOpen("test.txt", 1)
; Check if file opened for writing OK
If $file = -1 Then
MsgBox(0, "Error", "Unable to open file.")
Exit
EndIf
FileWrite($file, "Line1")
FileWrite($file, "Still Line1" & @CRLF)
FileWrite($file, "Line2")
FileClose($file)