DeleteElement

DeleteElement()

Syntaxe

Resultat = DeleteElement(Liste() [, Options])

Description

Supprime l'élément courant de la liste.

Arguments

Liste() Le nom la liste créée à l'aide de la commande NewList.
Les parenthèses sont obligatoires après le nom de la liste.

Options (optionnel) Si ce paramètre est égal à 1, le nouvel élément courant sera le suivant.
Cette option veille à ce que il y aie toujours un élément en cours de validité après une suppression aussi longtemps que il y a encore des éléments de la liste.

Valeur de retour

Renvoie l'adresse mémoire du nouvel élément courant de la liste.
Si la liste ne comporte aucun élément courant après la suppression, le résultat est 0.

Remarques

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()). Pour conserver quoiqu'il arrive un élément courant valide après un DeleteElement(), il suffit d'utiliser la valeur 1 dans le paramètre 'Options'. Le nouvel élément est alors l'élément qui suivait l'élément supprimé. Si la liste ne contenait plus qu'un seul élément, alors il n'y a plus d'élément courant.

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() - LinkedList Index - FirstElement() ->

Liste()	Le nom la liste créée à l'aide de la commande NewList. Les parenthèses sont obligatoires après le nom de la liste.
Options (optionnel)	Si ce paramètre est égal à 1, le nouvel élément courant sera le suivant. Cette option veille à ce que il y aie toujours un élément en cours de validité après une suppression aussi longtemps que il y a encore des éléments de la liste.