INSERER_ELT

ADELIA	VADELIA	SADELIA	WADELIA	MADELIA
(I/B)	(I/B) (C/S)	(B) (S)	(I/B) (C/S)	(I) (C/S)

Attention : dans le cas des programmes de type ADELIA, cet ordre n'est pas compatible avec le générateur C.

Paragraphe d'utilisation

Tous

Syntaxe

INSERER_ELT NomListe Position Modifier

Position	→	DEBUT \|FIN \|AVANT \|APRES
		\| TriDeZones
		\| Rien

Modifier	→	*MODIF \| Rien

Description

Cet ordre insère un nouvel élément dans la liste NomListe, en prenant les valeurs des variables qui la composent.

La position d'insertion Position indique l'endroit où est inséré le nouvel élément :

*DEBUT	En début de liste
*FIN	En fin de liste
*AVANT	Avant la position courante
*APRES	Après la position courante
*TRI(Zones)	Insertion par tri ascendant ou descendant par rapport à la ou aux zones spécifiées

La position est optionnelle, par défaut elle vaut *FIN.

Dans le cas d'une insertion triée, il faut définir les zones qui correspondent au tri. Par défaut, toutes les zones sont prises en compte. Pour les zones définies du tri, on peut préciser l'ordre, *ASC pour ascendant, *DESC pour descendant. Si rien n'est précisé, l'ordre par défaut est ascendant.

Cliquez ici pour l'explication de l'élément TriDeZones.

Le paramètre Modifier met l'élément inséré à l'état Modifié.

Attention : *MODIF ne peut pas être utilisé dans le cas des programmes de type ADELIA.

Après l'exécution de cette instruction, l'élément courant est l'élément inséré. Si l'opération s'est bien déroulée, &CODE_LST rend *NORMAL.

Voici les différents résultats :

Etat de la liste	Résultat
Liste vide	OK
Après une suppression	AVANT = APRES, FIN et DEBUT et *TRI : OK
Après la fin de la liste	AVANT = APRES = FIN, DEBUT et *TRI : OK
Avant le début de la liste	AVANT = APRES = DEBUT, FIN et *TRI : OK
Elément courant défini	OK