Funktionsreferenz

FileWriteLine

Fügt eine Zeile Text an das Ende einer zuvor geöffneten Textdatei.

FileWriteLine ( "filehandle/filename", "line" )

 

Parameter

filehandle/filename Das Handle der Datei, wie es von einem früheren Aufruf von FileOpen zurückgegeben wurde. Alternativ kann man einen String mit dem Dateinamen als ersten Parameter verwenden.
line Die Textzeile, die in die Datei geschrieben werden soll. Wenn die Zeile NICHT mit @CR oder @LF endet, dann wird automatisch ein MS-DOS-Zeilenvorschub (@CRLF) angefügt.

 

Rückgabewert

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

 

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ährend des Funktionsaufrufes geöffnet und geschlossen. Wenn man große Textdateien bearbeitet, ist das natürlich viel langsamer als die Arbeit mit Handles. Die Datei wird erstellt, wenn sie noch nicht existiert.

Hinweis: Nicht die Verwendung von Dateihandles und -namen vermischen. Beispielsweise sollte nicht eine Datei mit FileOpen geöffnet und dann in dieser Funktion ein Dateiname verwendet werden. Entweder Handles oder Dateinamen benutzen - nicht beides.

Wenn Text geschrieben wird, benutzt AutoIt standardmäßig ANSI. Um in Unicode zu schreiben, muss die Datei erst mit FileOpen() und den entsprechenden "mode"-Flags geöffnet werden.

Der zu Schreibende Text kann keine Chr(0) Druckzeichen enthalten, da die Ausgabe sonst beschnitten wird. FileWrite() unter Nutzung einer Datei, geöffnet im Binärmodus, muss genutzt werden um solche Druckzeichen zu schreiben.

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

 

Verwandte Funktionen

FileFlush, FileOpen, FileRead, FileReadLine, FileWrite, 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

FileWriteLine($file, "Zeile 1")
FileWriteLine($file, "Zeile 2" & @CRLF)
FileWriteLine($file, "Zeile 3")

FileClose($file)