:FILL
Script-Anweisung: Speichert mehrere Werte in einem Script-Array.
Syntax
: F[ILL] Script-Array = Werte
|
Syntax |
Beschreibung/Format |
|---|---|
| Script-Array |
Name der Script-Variablen, die als Array definiert wurde. Die Indexklammern sind dabei ohne Inhalt anzugeben. |
| Werte |
Werte die im Array gespeichert werden sollen. Tipp: Sie können die folgenden Script-Elemente verwenden, um Werte zuzuweisen: |
Die Script-Funktion dient dazu, mehrere Werte gleichzeitig in ein Script-Array abzulegen.
Verwenden Sie die Script-Anweisung :DEFINE, um das Array zu erstellen. Geben Sie die Array-Größe an, da Sie sonst keine Werte zuweisen können. Weitere Informationen finden Sie unter :DEFINE und Arrays.
Die Werte werden dabei immer ab dem ersten Elemente (Index = 1) in das Array geschrieben.
Übersteigt die Anzahl der zu speichernden Werte die Kapazität des Arrays, werden nur die ersten Werte abgelegt, die Platz im Array finden. Ist das Array größer als die ermittelten Werte, bleiben die restlichen Werte unverändert.
Das Script-Array ist für die Funktion mit leeren Indexklammern [] anzugeben.
Hinweis: Verwenden Sie :PUBLISH, um Arrays an unter- und übergeordnete Objekte weiterzugeben.
Beispiel
Im ersten Beispiel werden Werte eines VARA-Objekts mit GET_VAR im Array gespeichert.
: DEFINE &ARRAY# , string, 20
: FILL &ARRAY#[] = GET_VAR(VARA.TEST, KEY1)
:PRINT "Erster Wert der Variablen VARA.TEST, key KEY1: &ARRAY#[1]"
Im zweiten Beispiel werden die Spalten der ersten Zeile einer Log-Datei (Automation Engine) in das Array angelegt.
:DEFINE &ARRAY#, string, 20
:SET &HND# = PREP_PROCESS_FILE(WIN01, "C:\AUTOMIC\AUTOMATIONENGINE\TEMP\CPsrv_log_001_00.txt","*","COL=LENGTH""LENGTH_TAB,,,='8=DATE,1,6=TIME,7,200=TEXT'")
:PROCESS &HND#
:FILL &ARRAY#[] = GET_PROCESS_LINE(&HND#)
: ENDPROCESS
: SET &RUNVAR# = 1
:SET &LEN# = LENGTH(&ARRAY#[])
:WHILE &RUNVAR# LE &LEN#
:P "Line &RUNVAR#: &ARRAY#[&RUNVAR#]"
:SET &RUNVAR# = &RUNVAR# + 1
:ENDWHILE
Siehe auch:
seealso