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 les données du nouvel élément ou zéro si l'élément suivant n'existe pas.

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