Funktionsreferenz

FileWrite

Hängt Text/Daten an das Ende einer zuvor geöffneten txt-Datei.

FileWrite ( "filehandle/filename", "text/data" )

 

Parameter

filehandle/filename Das Handle der Datei, wie es von einem früheren Aufruf von FileOpen zurückgegeben wurde. Alternativ kann ein String mit dem Dateinamen als erster Parameter verwendet werden.
text/data Der Text/Die Daten, die in die Datei geschrieben werden soll(en). Die Zeile wird so wie sie ist in die Datei geschrieben. Es wird kein @CR oder @LF angehängt. Siehe Bemerkungen für die Datentypen.

 

Rückgabewert

Erfolg: Gibt 1 zurück.
Fehler: Gibt 0 zurück, wenn die Datei nicht im writemode geöffnet wurde, die Datei schreibgeschützt ist oder sie aus anderen Gründen nicht beschrieben werden konnte.

 

Bemerkungen

Die Datei muss im Schreibmodus (write mode) geöffnet sein, damit FileWrite keinen Fehler hervorruft.

Wenn ein Dateiname statt eines Dateihandles angegeben wird, wird die Datei während des Funktionsaufrufes geöffnet und geschlossen. Für die Bearbeitung großer Textdateien ist das viel langsamer als die Arbeit mit Handles. Wenn jedoch der Dateiname nicht existiert, wird eine entsprechende Datei angelegt.

Hinweis: Die Verwendung von Dateihandles und -namen sollte nicht vermischt werden. So sollte man z.B. vermeiden, eine Datei mit FileOpen zu öffnen und dann in dieser Funktion einen Dateinamen verwenden. Es sind entweder Handles oder Dateinamen zu benutzen - nicht beides.

AutoIt schreibt Text standardmäßig mit ANSI Kodierung. Um in Unicode Kodierung zu schreiben, muss die Datei mit FileOpen unter Verwendung der notwendigen Flags geöffnet werden.

Wenn die Daten ein binärer Datentyp (und kein Text) sind, wird byteweise in die Datei geschrieben. Der Binärmode kann auch durch Aufruf von FileOpen mit dem Binärmode Flag erzwungen werden.

Mit der Funktion _FileWriteToLine kann man auch an einer ganz bestimmter Stelle in einer Datei schreiben (z. B. an den Anfang der Datei)

 

Verwandte Funktionen

FileFlush, FileOpen, FileRead, FileReadLine, FileWriteLine, Binary, FileSetPos, FileGetPos

 

Beispiel


$file = FileOpen("test.txt", 1)

; Prüfen, ob Datei im Schreibmodus geöffnet ist
If $file = -1 Then
    MsgBox(0, "Fehler", "Die Datei konnte nicht geöffnet werden.")
    Exit
EndIf

FileWrite($file, "Zeile 1")
FileWrite($file, "Immer noch Zeile 1" & @CRLF)
FileWrite($file, "Zeile 2")

FileClose($file)