Fonction de script : Convertit un tableau de script en une chaîne de caractères.
ARRAY_2_STRING(Script Array, [Separator], [Area])
Syntaxe |
Description / format |
---|---|
Tableau de script |
Nom de Variable du tableau |
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 |
Codes retour |
---|
Chaîne de caractères contenant les éléments du tableau. |
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.
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. |
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