DeleteElement()

Syntaxe

*Resultat = DeleteElement(Liste() [, Options])
Description
Supprime l'élément courant de la liste.

Arguments

Liste() La liste à utiliser.
Options (optionnel) Si ce paramètre est égal à 1 et que le premier élément est supprimé alors le nouvel élément courant sera le second élément.
Cette option veille à ce qu'il y ait toujours un élément en cours de validité après une suppression aussi longtemps qu'il y a encore des éléments de la liste.

Valeur de retour

Renvoie une valeur non nulle qui est l'adresse du nouvel élément courant.
Si la liste ne comporte aucun élément courant après la suppression, le résultat est 0.

La valeur renvoyée est un pointeur sur le nouvel élément.

Remarques

Fonctionnement: Après l'appel de cette fonction, le nouvel élément courant est celui qui précédait l'élément supprimé. Si l'élément supprimé était le premier, alors il n'y a plus d'élément courant (la position dans la liste est avant le premier élément, comme après un ResetList()) sauf si Option=1 car dans ce cas le nouvel élément serait celui qui était en seconde position.

Exemple

  NewList personnes.s()

  AddElement(personnes()) : personnes() = "Tom"
  AddElement(personnes()) : personnes() = "Dick"
  AddElement(personnes()) : personnes() = "Harry"
  AddElement(personnes()) : personnes() = "Bob"

  FirstElement(personnes())     ; se déplace sur "Tom"
  DeleteElement(personnes(),1)  ; et le supprime. L'élément courant devient (paramètre 1 utilisé) celui qui suivait
  MessageRequester("Information", "La première personne de la liste est "+personnes(), #PB_MessageRequester_OK)

  LastElement(personnes())      ; se déplace vers "Bob"
  PreviousElement(personnes())  ; se déplace vers "Harry"
  DeleteElement(personnes())    ; et le supprime.Il y a un élément avant Harry, alors il devient l'élément courant
  MessageRequester("Information", "La personne actuellement pointée dans la liste est "+personnes(), #PB_MessageRequester_OK)

Voir aussi

AddElement(), InsertElement(), ClearList()

OS Supportés

Tous

<- CountList() - List Index - FirstElement() ->