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 |
|---|---|
|
Script Array |
Nom de la variable du tableau |
| Separator | 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 |
| Area |
Zone du tableau Valeurs autorisées : "ALL" ou "FILLED" (valeur par défaut) "ALL" : tous les éléments du tableau sont utilisés |
|
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 la variable du tableau doit être indiqué en incluant des crochets vides [].
Vous pouvez aussi déterminer un ou plusieurs séparateurs pour séparer les éléments les uns des autres dans la chaîne de caractères résultante.
Vous pouvez aussi définir si tous les éléments doivent être utilisés, ou uniquement ceux qui ont été saisis. Si seuls les éléments remplis doivent être utilisés, les éléments vides à la fin du tableau sont ignorés.
Exemples
L'exemple de script suivant illustre la création d'un tableau et le remplit avec les éléments d'un objet variable. Le tableau est ensuite converti dans une chaîne de caractères puis écrit 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#"
Voir aussi :