Manuel des Scripts Automation Engine > Organisation fonctionnelle > Chaînes de caractères > STR_SUBSTITUTE_VAR

STR_SUBSTITUTE_VAR, STR_SUB_VAR

Fonction script : Remplace le nom de Variables de scripts par leur valeur.

Syntaxe

STR_SUB[STITUTE]_VAR(Variables)

Elément de syntaxe

Description/format

Variables

Variable de script ou chaîne de caractères contenant un ou plusieurs noms de Variable
Format : littéral de script ou Variable de script

Code retour

Chaîne de caractères avec les valeurs des Variables de script

Remarques

L'élément STR_SUB_VAR permet de remplacer un ou plusieurs noms de Variables de script par la valeur de Variable réelle qui à leur tour sont enregistrés comme chaîne de caractères dans une autre Variable de script. Les exemples suivants permettent d'expliquer ce comportement.

Dans l'élément GET_PROCESS_LINE, il existe un paramètre qui est également désigné STR_SUB[STITUTE]_VAR et qui exécute le même remplacement pour la ligne d'une séquence de données.

Exemple

Dans l'exemple suivant, le nom d'une Variable de script (&VAR#) est enregistré dans une autre Variable (&VAR_NOSUB#) en indiquant deux fois le caractère &.

Si &VAR_NOSUB# s'affiche, le nom de la Variable de script &VAR# est écrit dans le protocole d'activation. Pour le remplacer également par la valeur de la Variable, l'élément STR_SUB_VAR doit être utilisé.

:SET &VAR#"Variable de script"
:SET &VAR_NOSUB#"&&VAR# = &VAR#"
:PRINT &VAR_NOSUB#
:SET &VAR_SUB#STR_SUB_VAR(&VAR_NOSUB#)
:PRINT &VAR_SUB#

Affichage dans le protocole d'activation :

2011-05-06 10:34:04 - U0020408 &VAR# = Variable de script
2011-05-06 10:34:04 - U0020408 Variable de script = Variable de script

 

Dans le deuxième exemple, une valeur est déterminée à partir de l'objet Variable VARA.SUB qui à son tour contient le nom de 2 Variables de script. Ces 2 Variables de script sont ensuite créées et exécutées.

Si la valeur de l'objet Variable s'affiche directement, seuls les noms des Variables de script sont écrits dans le rapport. Aucun remplacement direct des valeurs n'est effectué.

Pour remplacer les noms des 2 Variables de script par leur valeur, l'élément STR_SUB_VAR est nécessaire.

:SET &VARA# = GET_VAR(VARA.SUB, "SUBVAR")
:SET &VAR1# = "Hello"
:SET &VAR2# = "World"
:PRINT "Contenu sans remplacement : &VARA#"
:SET &VARA_SUB_VAR# = STR_SUB_VAR(&VARA#)
:PRINT "Contenu avec remplacements : &VARA_SUB_VAR#"

Sortie d'abord sans, puis avec STR_SUB_VAR :

2011-05-06 10:34:04 - U0020408 Contenu sans remplacement : &VAR1# &VAR2#
2011-05-06 10:34:04 - U0020408 Contenu avec remplacements : Hello World

 

Rubriques connexes :

Elément de script Description
Elément de script Description
GET_PROCESS_LINE Détermine le contenu actuel des lignes d'une séquence de données.