APPEND TO ARRAY

4D v16.3

APPEND TO ARRAY


APPEND TO ARRAY ( tableau ; valeur )

Paramètre	Type	Description
tableau	Tableau	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)

Voir aussi

DELETE FROM ARRAY
INSERT IN ARRAY