FileWriteFields (Funktion)
- Last UpdatedSep 26, 2024
- 2 minute read
Schreibt Daten aus einer Folge von Variablen in eine CSV-Datei. Mit dieser Funktion können Sie beispielsweise einen ganzen Satz von Variablenwerten auf einmal in eine Datei schreiben.
Als Trennzeichen in der Datei werden ausschließlich Kommas unterstützt.
Syntax
[Ergebnis = ] FileWriteFields (Dateiname, StartPos, StartVariable, AnzahlFelder)
Parameter
filename
Der Name der CSV-Datei, in die die Daten geschrieben werden sollen. Falls die Datei noch nicht existiert, wird sie erstellt. 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.
StartVariable
Der Name der Variablen, die den ersten Wert enthält, der geschrieben werden soll. Der Name der Variablen muss mit einer Zahl aufhören (z. B. "IVar1"). Sie müssen den Namen der Variablen als Zeichenfolgenwert angeben. Wenn Sie beispielsweise die Variable IVar1 verwenden möchten, müssen Sie an die Stelle dieses Parameters entweder den Zeichenfolgenwert "IVar1" oder den Punktfeldverweis IVar1.Name setzen. Zeichenfolgenkonstante, Meldungsvariable oder Zeichenfolgenausdruck.
AnzahlFelder
Gibt an, wie viele Werte in die CSV-Datei geschrieben werden sollen. Wert, Variable oder Ausdruck vom Typ Integer. Der erste Wert wird aus der Variablen gelesen, die im Parameter "StartVariable" angegeben ist. Für die folgenden Werte wird der Index dieser Variablen hochgezählt. Wenn der erste Wert beispielsweise aus der Variablen "Var1" gelesen wird, wird der zweite Wert aus der Variablen "Var2" gelesen, der dritte Wert aus der Variablen "Var3" usw.
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 folgenden InTouch-Variablen sind definiert:
|
Tag-Name |
Datentyp in |
Wert |
|---|---|---|
|
RezepturVar1 |
Meldung |
Mehl |
|
RezepturVar2 |
Real |
27,23 |
|
RezepturVar3 |
Ganze Zahl |
14 |
|
RezepturVar4 |
Binär |
1 |
Die folgende Anweisung schreibt die Werte der Variablen RezepturVar1 bis RezepturVar4 in die Datei C:\Rezept.csv.
FileWriteFields("c:\Rezept.csv", 0, "RezepturVar1", 4);
Die Datei C:\Rezept.csv enthält nun die folgenden Daten:
Mehl,27.23,14,1