AddElement()

Syntaxe

*Resultat = AddElement(Liste())

Ajoute un nouvel élément après l'élément courant.

Arguments

Liste()

La liste à utiliser.

Valeur de retour

Renvoie une valeur non nulle qui est l'adresse du nouvel élément si le nouvel élément a été ajouté, zéro sinon.

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

Remarques

Devient le premier élément si la liste était vide et il devient l'élément courant de la liste.

Exemple

  ; La manière la plus simple d'utiliser AddElement
  NewList simple.w()
  AddElement(simple())    ; Crée le premier nouvel élément de la liste
  simple() = 23

  AddElement(simple())    ; La position courante est le premier élément, alors nous en ajoutons un à la deuxième position
  simple() = 45


  ; Ceci montre comment utiliser la valeur de retour de la fonction AddElement
  NewList experimentes.l()
  If AddElement(experimentes()) <> 0
    experimentes() = 12345
  Else
    MessageRequester("Erreur !", "Impossible d'allouer de la mémoire pour le nouvel élément", #PB_MessageRequester_OK)
  EndIf


  ; Une petite structure pour montrer l'utilisation du pointeur.
  Structure Programmeur
    Nom.s
    Talent.b
  EndStructure

  NewList LesProgrammeurs.Programmeur()  ; La liste qui stocke les éléments

  *Element.Programmeur = AddElement(LesProgrammeurs())
  If *Element<>0
    *Element\Nom = "David"
    *Element\Talent = 3   ; Celui-là, c'est un féru de PureBasic ! ;)
  Else
    MessageRequester("Erreur !", "Impossible d'allouer de la mémoire pour le nouvel élément", #PB_MessageRequester_OK)
  EndIf

Voir aussi

InsertElement(), DeleteElement(), ClearList()

OS Supportés

Tous