INSERT IN ARRAY
INSERT IN ARRAY ( tableau ; positionDépart {; combien} )
| Paramètre | Type | Description | |
|---|---|---|---|
| tableau | Array | → | Nom du tableau dans lequel insérer des éléments |
| positionDépart | Integer | → | Position de départ du ou des élément(s) à insérer |
| combien | Integer | → | Nombre d'éléments à insérer ou 1 élément si ce paramètre est omis |
Description
INSERT IN ARRAY insère un ou plusieurs éléments ou "lignes" dans le tableau tableau. Les nouveaux éléments sont insérés avant l'élément spécifié par positionDépart, et initialisés à la valeur vide du type du tableau. Tous les éléments situés au-delà de positionDépart sont décalés vers le bas d'un offset ou de la valeur spécifiée par combien.
Si positionDépart est supérieur à la taille du tableau, les éléments sont insérés à la fin du tableau.
Le paramètre combien représente le nombre de lignes à insérer. Si combien n'est pas spécifié, un seul élément est inséré. La taille du tableau est augmentée de combien.
Exemple 1
L'exemple suivant insère cinq nouveaux éléments à partir de l'élément 10 :
INSERT IN ARRAY(unTableau;10;5)
Exemple 2
L'exemple suivant ajoute un élément à un tableau :
$vlElem:=Size of array(unTableau)+1
INSERT IN ARRAY(unTableau;$vlElem)
unTableau{$vlElem}:=...