PUT_PROCESS_LINE
Script-Funktion: Fügt einer bestimmten Datensequenz eine Zeile hinzu.
Syntax
PUT_PROCESS_LINE (Datensequenz, Zeile [ , Trennzeichen ])
Syntax | Beschreibung/Format |
|---|---|
Datensequenz | Verweis auf die Datensequenz, der eine Zeile hinzugefügt werden soll. |
| Zeile | Die Zeile, die der Datensequenz hinzugefügt werden soll Hinweis: Auch die Angabe eines Script-Arrays ist möglich. |
Trennzeichen | Beliebiges Zeichen, welches die angegebene Zeile in Spalten aufteilt. Wird für Zeile ein Array angegeben, besitzt dieser Parameter keine Wirkung. |
|
Rückgabewert |
|---|
|
"0" - Datensequenz wurde erfolgreich um die angegebene Zeile erweitert. |
Die Script-Funktion fügt einer Datensequenz eine neue Zeile hinzu. Die Datensequenz wird dabei direkt geändert - der Rückgabewert der Funktion zeigt nur, ob das Hinzufügen der Zeile erfolgreich durchgeführt werden konnte. Dabei ist der Verweis auf die zu ändernde Datensequenz und der Wert, der als neue Zeile eingefügt werden soll, anzugeben.
Wichtig!
- Stellen Sie sicher, dass Sie eine Datensequenz angeben, die vorhanden ist und die nicht mit der Anweisung :CLOSE_PROCESS geschlossen wurde. Ansonsten kommt es zu einem Laufzeitfehler. Weitere Informationen finden Sie unter :CLOSE_PROCESS.
- Mit dieser Scirpt-Funktion kann keine neue Datensequenz erstellt werden.
Tipp: Erstellen Sie Datensequenzen mit den Script-Elementen CREATE_PROCESS oder PREP_PROCESS*. Weitere Informationen finden Sie unter Script-Elemente für Datensequenzen.
Die hinzuzufügende Zeile kann dabei entweder in Form eines Strings (Script-Literal bzw. Script-Variable) oder eines Script-Arrays (Script-Variable) angegeben werden. Wenn Sie einen String verwenden, kann ein Trennzeichen angegeben werden, um sie in Spalten aufzuteilen. Wird kein Trennzeichen spezifiziert, so besitzt die neue Zeile nur eine Spalte, die den kompletten Wert enthält.
Wenn Sie ein Script-Array angeben, wird es automatisch nach seinen Elementen in Spalten aufgeteilt. Die leeren Elemente am Ende des Arrays werden nicht verwendet.
Beispiele
Im folgendem Beispiel wird eine Datensequenz erstellt, welche eine Dateiliste speichert. Anschließend wird ein Dateiname aus einem VARA-Objekt abgerufen und der Datensequenz hinzugefügt.
:SET &HND# = PREP_PROCESS_FILENAME("WIN01","C:\AUTOMIC\temp\test*.txt","Y",,)
:SET &LINE# = GET_VAR(VARA.FILELIST)
:SET &RET# = PUT_PROCESS_LINE(&HND#,&LINE#)
Siehe auch: