Script-Statement: Setzt ein Script-Array auf seine Anfangswerte zurück.
Syntax
:CLEAR Script Array
|
Syntax |
Beschreibung/Format |
|---|---|
|
Script Array |
Variablenname des Script-Arrays, welches zurückgesetzt werden soll. |
Durch diese Script-Anweisung kann ein bereits verwendetes Script-Array auf seine Initialwerte zurückgesetzt werden. Dadurch werden alle Werte gelöscht und das Array auf den selben Zustand zurückgesetzt, den es direkt nach Deklaration (:DEFINE) hatte.
Das Array ist dabei inklusive der leeren Indexklammern [] anzugeben.
Das Sprachmittel löscht nur den Inhalt des Arrays, die Variable selbst bleibt jedoch bestehen. Eine anschließende neue Definition des Arrays ist daher nicht möglich.
Beispiele
Folgendes Beispiel definiert ein Array und befüllt es mit den Werten einer Zeile eines statischen Variablen-Objektes. Diese Werte werden im Aktivierungsreport ausgegeben. Anschließend wird das Array geleert und mit einem anderen Variablen-Eintrag befüllt. Die neuen Werte werden anschließend ebenfalls in das Aktivierungsprotokoll geschrieben.
:DEFINE &ARRAY#, string, 5
:DEFINE &STR#, string
:FILL &ARRAY#[] = GET_VAR(VARA.STATIC.TEST,"KEY01")
:SET &STR# = ARRAY_2_STRING(&ARRAY#[])
:P "KEY01: &STR#"
:CLEAR &ARRAY#[]
:FILL &ARRAY#[] = GET_VAR(VARA.STATIC.TEST,"KEY02")
:SET &STR# = ARRAY_2_STRING(&ARRAY#[])
:P "KEY02: &STR#"
Siehe auch: