ListIndex()

Syntax

Index = ListIndex(LinkedList())

Gibt die Position des aktuellen Listenelements zurück - dabei wird davon ausgegangen, dass sich das erste Element an Position 0 befindet. Diese Funktion ist sehr schnell und kann ohne Performanzverlust auch häufig verwendet werden (sie durchläuft nicht jedes Mal die gesamte Liste, sondern nutzt einen zwischengespeicherten Wert).

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 beinhaltet die Position des aktuellen Elements in der Liste. Das erste Element befindet sich dabei an Position 0, das nächste an 1 und so weiter. Ein Rückgabewert von -1 bedeutet, dass es kein aktuelles Element gibt (entweder ist die Liste leer, Sie haben sich mittels PreviousElement() oder NextElement() über den Beginn oder das Ende der Liste hinaus bewegt, oder Sie haben ResetList() benutzt).

Beispiel:

  NewList fruit.s()

  AddElement(fruit()) : fruit() = "oranges"
  AddElement(fruit()) : fruit() = "bananas"
  AddElement(fruit()) : fruit() = "apples"
  AddElement(fruit()) : fruit() = "pears"

  FirstElement(fruit())
  MessageRequester("Fruit: "+fruit(), "Jetzt an Position "+Str(ListIndex(fruit())),  #PB_MessageRequester_OK)

  NextElement(fruit())
  MessageRequester("Fruit: "+fruit(), "Jetzt an Position "+Str(ListIndex(fruit())),  #PB_MessageRequester_OK)

  NextElement(fruit())
  MessageRequester("Fruit: "+fruit(), "Jetzt an Position "+Str(ListIndex(fruit())),  #PB_MessageRequester_OK)

  NextElement(fruit())
  MessageRequester("Fruit: "+fruit(), "Jetzt an Position "+Str(ListIndex(fruit())),  #PB_MessageRequester_OK)

Unterstützte OS

All