APPEND TO ARRAY
APPEND TO ARRAY ( tableau ; valeur )
| Paramètre | Type | Description | |
|---|---|---|---|
| tableau | Array | → | Tableau auquel ajouter une valeur |
| valeur | Expression | → | Valeur à ajouter au tableau |
Description
La commande APPEND TO ARRAY ajoute une nouvelle ligne à la fin du tableau et lui affecte la valeur passée dans le paramètre valeur. En mode interprété, si le tableau n’a pas été défini au préalable, la commande le crée et lui attribue un type en fonction de celui de valeur.
Cette commande fonctionne avec tous les types de tableaux : chaîne, numérique, booléen, date, pointeur et image.
Le type de valeur doit correspondre au type du tableau, sinon l’erreur de syntaxe 54 “Les arguments sont incompatibles” est générée. Les combinaisons suivantes sont toutefois possibles :
- un tableau de type chaîne (Texte ou Alpha) accepte toute valeur de type Texte ou Alpha.
- un tableau de type numérique (Entier, Entier long ou Réel) accepte toute valeur de type Entier, Entier long, Numérique ou Heure.
Exemple
Le code suivant :
INSERT IN ARRAY($montableau;Size of array($montableau)+1)
$montableau{Size of array($montableau)}:=$mavaleur
... peut être remplacé par :
APPEND TO ARRAY($montableau;$mavaleur)