FileReadMessage (Funktion)

Liest die angegebene Anzahl Bytes (oder eine vollständige Textzeile) als Zeichenfolge aus der angegebenen Datei.

Syntax

[Ergebnis = ] FileReadMessage (Dateiname, StartPos, Meldungsvariable, AnzahlZeichen)

Parameter

filename

Der Name der Datei, aus der die Daten gelesen werden sollen. Zeichenfolgenkonstante, Variable oder Ausdruck.

offset

Gibt an, an welcher Byteposition in der Datei der Lesevorgang beginnen soll. Wert, Variable oder Ausdruck vom Typ Integer.

messagetag

Die Meldungsvariable, in die die gelesenen Daten geschrieben werden. Schreiben Sie den Variablennamen in doppelten Anführungszeichen, wenn die Funktion im Industriegrafik-Editor Skripteditor verwendet wird.

AnzahlZeichen

Gibt an, wie viele Byte aus der Datei gelesen werden sollen. Wenn Sie 0 angeben, wird bis zum nächsten Zeilenvorschub (Line-Feed-Zeichen, LF) gelesen. Wert, Variable oder Ausdruck vom Typ Integer.

Rückgabewert

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

Beispiel(e)

Die folgende Anweisung liest die erste Zeile aus der Datei C:\Daten\Datei.txt und schreibt sie in die Meldungsvariable MVar.

FileReadMessage ("C:\Daten\Datei.txt", 0, MVar, 0);

FileReadMessage ("C:\Daten\Datei.txt", 0, "InTouch:MVar", 0);