FileWriteMessage (Funktion)

Schreibt die angegebene Anzahl Bytes (oder eine vollständige Textzeile) als Zeichenfolge in die angegebene Datei.

Syntax

[Ergebnis = ] FileWriteMessage (Dateiname, StartPos, Meldungsvariable, Zeilenvorschub)

Parameter

filename

Der Name der Datei, in die die Daten geschrieben werden sollen. Zeichenfolgenkonstante, Variable oder Ausdruck.

offset

Gibt an, an welcher Byteposition in der Datei der Schreibvorgang beginnen soll. Um die Daten am Ende der Datei anzuhängen, verwenden Sie den Wert -1. Wert, Variable oder Ausdruck vom Typ Integer.

messagetag

Die Meldungsvariable, deren Inhalt in die Datei geschrieben werden soll.

linefeed

Legt fest, ob nach den geschriebenen Daten ein Zeilenvorschub (Line-Feed-Zeichen, LF) in die Datei eingefügt werden soll. Um einen Zeilenvorschub einzufügen, setzen Sie diesen Parameter auf 1, anderenfalls auf 0. Binärwert, -variable oder -ausdruck.

Rückgabewert

Die Byteposition in der Datei, bis zu der in diesem Schreibvorgang Daten geschrieben wurden. Diesen Wert können Sie als Startposition für den nächsten Schreibvorgang verwenden.

Beispiel(e)

Die folgende Anweisung hängt den Inhalt der Meldungsvariablen MsgTag an die Datei c:\Data\File.txt an.

FileWriteMessage("C:\Daten\Datei.txt", -1, MVar, 1);