4D Doc Center : INSERER DANS TABLEAU

4D v13.4

INSERER DANS TABLEAU


INSERER DANS TABLEAU ( tableau ; positionDépart {; combien} )

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

Description

INSERER DANS TABLEAU 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 :

INSERER DANS TABLEAU(unTableau;10;5)

Exemple 2

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

 $vlElem:=Taille tableau(unTableau)+1

 INSERER DANS TABLEAU(unTableau;$vlElem)

 unTableau{$vlElem}:=...