4D v16.3

INSERT IN ARRAY

Accueil

 
4D v16.3
INSERT IN ARRAY

INSERT IN ARRAY 


 

INSERT IN ARRAY ( tableau ; positionDépart {; combien} ) 
Paramètre Type   Description
tableau  Tableau in Nom du tableau dans lequel insérer des éléments
positionDépart  Entier long in Position de départ du ou des élément(s) à insérer
combien  Entier long in Nombre d'éléments à insérer ou 1 élément si ce paramètre est omis

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.

L'exemple suivant insère cinq nouveaux éléments à partir de l'élément 10 :

 INSERT IN ARRAY(unTableau;10;5)

L'exemple suivant ajoute un élément à un tableau :

 $vlElem:=Size of array(unTableau)+1
 INSERT IN ARRAY(unTableau;$vlElem)
 unTableau{$vlElem}:=...



Voir aussi  

DELETE FROM ARRAY
Size of array

 
PROPRIÉTÉS 

Produit : 4D
Thème : Tableaux
Numéro : 227

Commande(s) éligible(s) à l'exécution dans un process préemptif

 
HISTORIQUE 

Modifié : 4D v11 SQL

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v16)
4D - Langage ( 4D v16.1)
4D - Langage ( 4D v16.2)
4D - Langage ( 4D v16.3)