Script-Funktion: Fügt einer bestimmten Datensequenz eine Zeile hinzu.
Syntax
PUT_PROCESS_LINE (Data sequence, Row [ , Delimiter ])
|
Syntax |
Beschreibung/Format |
|---|---|
|
Data sequence |
Verweis auf die Datensequenz, der eine Zeile hinzugefügt werden soll. |
| Row |
Die Reihe, die der Datensequenz hinzugefügt werden soll Auch die Angabe eines Script Arrays ist möglich. |
|
Delimiter |
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.
Datensequenzen können mit dem Sprachmittel CREATE_PROCESS oder mit den PREP_PROCESS* - Funktionen erstellt werden.
Achten Sie darauf, dass die Datensequenz, deren Referenz angegeben wurde, tatsächlich existiert oder nicht bereits via :CLOSE_PROCESS geschlossen wurde. Ansonsten kommt es zu einem Laufzeitfehler. Mit dem Sprachmittel kann keine neue Datensequenz erstellt werden.
Die hinzuzufügende Zeile kann dabei entweder in Form einer Zeichenkette (Script-Literal bzw. Script-Variable) oder eines Script-Array (Script-Variable) angegeben werden. Wenn Sie eine Zeichenkette 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 Variablenobjekt 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: