|
GET_SCRIPT_VAR |
Elaboration et traitement des Scripts |
Traitement des erreurs et messages |
|
| Fonction script : Détermine la longueur d'un Tableau de script. |
LENGTH(Tableau de Scrip[, SIZE])
|
Elément de syntaxe |
Description/format |
|---|---|
|
Tableau de script |
Nom de la Variable de script qui a été déclarée comme tableau. |
| SIZE | Ignorer les éléments vides à la fin du tableau |
|
Codes retour |
|---|
|
Nombre d'éléments du tableau de script. |
Les tableaux de script doivent être créés avec l'élément de script :DEFINE. Le type de données et le nombre d'éléments y sont aussi déterminés. La taille du tableau peut ensuite être déterminée avec la fonction script LENGTH. Le tableau doit être indiqué avec des crochets vides.
La taille maximale des tableaux de script est 99999.
Si le tableau indiqué est introuvable ou qu'une Variable de script a été indiquée, une erreur de script se produit.
Lorsque le paramètre SIZE est également spécifié, seul le nombre jusqu'au dernier élément de tableau complété est retourné. Tous les éléments vides à la fin du tableau ne sont donc pas pris en compte.
Veuillez noter que la détermination de la taille jusqu'au dernier élément complété (paramètre SIZE) est possible uniquement lorsque le tableau présente le type de données "string". Pour tous les autres types de données, la taille complète du tableau est toujours retournée !
Dans l'exemple suivant, un tableau de script est créé, complété avec des valeurs issues d'un objet Variable, puis les valeurs s'affichent à l'aide d'une boucle.
:DEFINE &ARRAY#, string, 5
:SET &LEN# = LENGTH(&ARRAY#[])
:SET &VAR# = 1
:FILL &ARRAY#[] = GET_VAR(VARA1, ARRAY)
:WHILE &VAR# LE &LEN#
:PRINT "Element &VAR# = &ARRAY#[&VAR#]"
:SET &VAR# = &VAR# + 1
:ENDWHILE
Rubriques connexes :
| Elément de script | Description |
|---|---|
|
Enregistre plusieurs valeurs dans un Tableau de script. |
|
| FIND | Recherche un Tableau de script et retourne l'Index correspondant. |
Elément de script - Données d'activation
Généralités sur les scripts
Elément de script - Liste alphabétique
Elément de script - Division fonctionnelle