NextElement()

Syntax

Ergebnis = NextElement(LinkedList())

Wechselt vom aktuellen Element auf das nächste Element in der Liste, oder auf das erste Element, wenn Sie zuvor ResetList() aufgerufen haben.

Parameter:
LinkedList() - Der Variablenname der verknüpften Liste, welche mit dem NewList Befehl erstellt wurde. Sie müssen die Klammern nach dem Listennamen immer angeben.

Rückgabewert:
Der von diesem Befehl zurückgegebene Wert zeigt an, ob das nächste Element existiert oder nicht (es existiert nicht, wenn die Liste leer ist). Existiert das nächste Element, wird dieser Befehl einen Wert ungleich Null zurückgeben. Wenn das nächste Element nicht existiert, wird ein Wert von Null zurückgegeben.

Nur für fortgeschrittene Anwender:
Der Wert, den dieser Befehl zurückgibt, ist ein Zeiger auf die Daten des nächsten Elements, oder Null wenn das nächste Element nicht existiert.

Beispiel:

  NewList Scores.w()

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

  ResetList(Scores())
  While NextElement(Scores())
    ; Dies ist OK, da der erste Aufruf von NextElement() das erste Element in der Liste zum aktuellen Element macht
    MessageRequester("Score", Str(Scores()), #PB_MessageRequester_OK)
  Wend

Unterstützte OS

Alle