Manuel des Scripts Automation Engine > Organisation fonctionnelle > Elaboration et traitement des Scripts > :CLEAR

:CLEAR

Instruction de script : Réinitialise un tableau de script avec ses valeurs initiales.

Syntaxe

:CLEAR Script Array

Syntaxe	Description / format
Tableau de script	Nom de variable du tableau de script devant être réinitialisé. Format : variable de script

Remarques

Cette instruction de script permet de réinitialiser un tableau de script déjà utilisé avec ses valeurs initiales. Toutes les valeurs sont alors supprimées et le tableau est réinitialisé au même statut qu'il possédait juste avant la déclaration (:DEFINE).

Le tableau doit être indiqué en incluant des crochets vides [].

L'élément de script supprime uniquement le contenu du tableau, mais la variable est conservée. Une nouvelle définition consécutive du tableau est par conséquent impossible.

Exemples

L'exemple suivant définit un tableau et le remplit par les valeurs d'une ligne d'un objet Variable statique. Ces valeurs s'affichent dans le rapport d'activation. Le tableau est ensuite vidé puis rempli par un autre élément de Variable. Les nouvelles valeurs sont ensuite également reportées dans le protocole d'activation.

: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#"

Rubriques connexes :

Eléments de script	Description
:DEFINE	Déclare une variable de script avec un type spécifique de données.

Eléments de script - Structure et traitement des scripts

Généralités sur les scripts
Eléments de script - Liste alphabétique
Eléments de script - Répartition fonctionnelle