DeleteElement

Commande de liste

Syntaxe

Supprime l'élément courant. L'élément qui le précède devient l'élément courant.

DeleteElement(<list>() [, <flags>])

Les éléments

<list>	Une liste déclarée avec `NewList`, écrite avec ses parenthèses vides : `scores()`.
<flags>	Facultatif, 0 par défaut. Toute valeur autre que 0 ne change qu'un cas : quand on supprime le premier élément, le nouveau premier devient courant au lieu d'aucun.

Rend

1 si un élément est courant après la suppression, sinon 0. Aussi 0, sans rien supprimer, quand il n'y avait pas d'élément courant.

À savoir

Sans <flags>, supprimer le premier élément ne laisse aucun élément courant : ListIndex() renvoie -1, et le NextElement() suivant va au nouveau premier élément.
Supprimer dans un FOREACH ne pose pas de problème : la boucle continue avec l'élément qui suivait.
Après FreeList(), l'appel arrête le programme avec « BASIC list is not initialized ».

Exemple

NewList a.integer()FOR k = 1 TO 3  AddElement(a())  a() = k * 10NEXTSelectElement(a(), 1)r = DeleteElement(a())Console(Str(r) + " " + Str(a()))   ' 1 10FirstElement(a())r = DeleteElement(a(), 1)Console(Str(r) + " " + Str(a()))   ' 1 30

Dans le manuel : Tableaux, listes et maps