NextElement()

Syntaxe

Resultat = NextElement(ListeChainee())

Passe de l'élément courant à l'élément suivant de la liste, ou au premier élement si vous avez précédement fait appel à ResetList()

Argument

ListeChainee() - Le nom de votre variable liste chaînée, créée à l'aide de la commande NewList. Les parenthèses sont obligatoires après le nom de la liste.

Valeur de retour

La valeur renvoyée par cette commande peut être utilisée pour déterminer si l'élément suivant existe ou pas (il n'existera pas si vous êtes à la fin de la liste). Si l'élément suivant existe, la valeur renvoyée est différente de zéro. Si l'élément suivant n'existe pas alors la valeur renvoyée sera zéro. Pour programmeurs expérimentés: La valeur renvoyée par cette commande est un pointeur vers le nouvel élément ou zéro si l'élément suivant n'existe pas. La structure de chaque élément est définie ci-dessous :

  Structure Element
    *Next.Element        ; Pointeur vers l'élément suivant de la liste ou zéro si c'est le dernier élément
    *Previous.Element    ; Pointeur vers l'élément précédent de la liste ou zéro si c'est le premier élément

    ; La structure utilisée par la liste suit directement ces 2 variables (ce qui implique que les
    ; données utilisateurs se situent à l'adresse du nouvel élément + 8 octets).
  EndStructure

Vous ne devriez pas changer les pointeurs du début de la liste, car ça casserait la structure interne de la liste.

Exemple:

  NewList scores.w()

  For i=1 To 10
    AddElement(scores())
    scores() = 100 - i
  Next

  ResetList(scores())
  While NextElement(scores())
    ; Ceci est correct car le premier appel à NextElement() va déplacer l'élément courant vers le premier élément de la liste
    MessageRequester("Score", Str(scores()), #PB_MessageRequester_OK)
  Wend

OS Supportés

Tous