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 oder ResetList() wurde 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

Alle