AutoIt.@ - Hilfe

Zu der Funktionsliste

FileWrite

Fügt einen Text/Daten an das Ende einer zuvor geöffneten Datei an.

FileWrite ( <handle> $Dateihandle , <str> $Text )

Parameter

ParameterTypStandardwertBeschreibung
$Dateihandlehandle (Kennung) Das Handle einer Datei, welches von einem vorhergehenden FileOpen zurückgegeben wurde. Alternativ kann auch ein Dateiname im String-Format als erster Parameter genutzt werden.
$Textstring (Zeichenkette) Der Text/Die Daten, welche in die Datei geschrieben werden sollen. Der Text wird so in die Datei geschrieben wie er ist - @CR oder @LF Zeichen werden nicht hinzugefügt. Für weitere Bemerkungen siehe unter Bemerkung.

Rückgabewert

Bei Erfolg: Gibt 1 zurück.
Bei Fehler: Gibt 0 zurück, wenn die datei nicht im Schreibmodus geöffnet wurde, die Datei Schreibgeschützt ist oder aus einem anderen Grund nicht in die Datei geschrieben werden kann.

Bemerkung

Die Datei muss im Schreib-Modus geöffnet werden, oder der FileWrite Befehl wird fehlschlagen. Wenn anstatt eines Datei-Handles ein Dateiname angegeben ist, dann wird die Datei während des Funktionsaufrufes geöffnet und geschlossen. Für die Verarbeitung großer Textmengen ist dieser Weg viel langsamer als wenn man ein Datei-Handle nutzt. Davon abgesehen wird die Datei erstellt, sollte sie nicht schon existieren. Hinweis: Vermische nicht den Gebrauch von Datei-Handles und Dateinamen, also benutze nicht zuerst FileOpen() für eine Datei und benutze dann den Dateinamen dieser Datei in der FileWrite Funktion. Benutze entweder Datei-Handles oder Dateinamen, nicht beides. Beim Schreiben von Text wird AutoIt vom Standard her ANSI benutzen. Um Unicode zu schreiben muss die Datei zuvor mit FileOpen() mit den entsprechenden Flaggen geöffnet werden. Wenn die Daten vom Typ Binär sind (und nicht Text), dann werden sie Byte für Byte in die Datei geschrieben. Binäropertionen können ebenso erzwungen werden, indem man die Datei mit FileOpen() mit der Binär-Kennzeichnung öffnet.

In Verbindung stehende Befehle

FileFlush
FileOpen
FileRead
FileReadLine
FileWriteLine
Binary
FileSetPos
FileGetPos

Beispiel    

$Datei = FileOpen("test.txt", 1)
 
; Prüft, ob die Datei zum Beschreiben geöffnet werden konnte
If $Datei = -1 Then
MsgBox(0, "AutoIt.@", "Fehler: Konnte die Datei nicht öffnen.")
Exit
EndIf
 
FileWrite($Datei, "Zeile 1")
FileWrite($Datei, "Immer noch Zeile 1" & @CRLF)
FileWrite($Datei, "Zeile 2")
 
FileClose($Datei)