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 das nächste Element, oder Null wenn das nächste Element nicht existiert. Die Struktur jedes Elements wird nachfolgend dargestellt:

  Structure Element
    *Next.Element        ; Zeiger auf das nächste Element in der Liste oder Null, wenn es das letzte Element ist
    *Previous.Element    ; Zeiger auf das vorherige Element in der Liste oder Null, wenn es das erste Element ist
  
    ; Die Datentypen des Anwenders, mit denen die Liste erstellt wurde, folgen nach diesen
    ; zwei Variablen (was bedeutet, das die Anwenderdaten wie folgt gefunden werden können:
    ; Adresse des neuen Elements + 8
  EndStructure 

Sie sollten die Zeiger am Anfang der Elemente nicht verändern, das dies die Struktur der Liste durcheinander bringt, was zu allen möglichen Problemen führen kann.

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

All