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

ARRAY_2_STRING

Fonction de script : Convertit un tableau de script en une chaîne de caractères.

Syntaxe

ARRAY_2_STRING(Script Array, [Separator], [Area])

Syntaxe

Description / format

Tableau de script

Nom de Variable du tableau
Format : variable de script

Séparateur Un ou plusieurs caractères devant être ajouté(s) dans la chaîne de caractères entre les éléments du tableau.
Format : variable de script ou litéral de script
Domaine

Zone du tableau

Valeurs autorisées : "ALL" ou "FILLED" (valeur par défaut)

"ALL" = Utiliser tous les éléments du tableau
"FILLED" = Enregistrer tous les éléments jusqu'au dernier élément rempli.

Codes retour

Chaîne de caractères contenant les éléments du tableau.

Commentaires

Cette fonction de script renvoie les éléments d'un tableau de script sous forme d'une chaîne de caractères. Le nom de Variable du tableau doit être indiqué en incluant des crochets vides [].

Un ou plusieurs séparateurs permettant de séparer les éléments dans la chaîne de caractères en résultant peuvent en plus être définis.

Vous pouvez aussi définir si tous les éléments doivent être utilisés, ou uniquement ceux qui ont été saisis. Dans le dernier cas, les éléments vides à la fin du tableau sont ignorés.

Exemples

Dans l'exemple suivant, le script crée un tableau est créé et le remplit avec les éléments d'un objet variable. Le tableau est ensuite converti dans une chaîne de caractères puis affiché dans le rapport d'activation. Un tiret est utilisé comme séparateur des éléments du tableau.

:DEFINE &ARRAY#, string, 5
:DEFINE &STR#, string
:FILL &ARRAY#[] = GET_VAR(VARA.STATIC.TEST,"KEY01")
:SET &STR# = ARRAY_2_STRING(&ARRAY#[],"-",FILLED)
:P "&STR#" 

 

Rubriques connexes :

Eléments de script Description
:CLEAR Réinitialise un tableau de script avec ses valeurs initiales.

:DEFINE

Déclare une variable de script avec un type spécifique de données.