ListIndex()

Syntax

Index = ListIndex(Liste())

Findet die Position des aktuellen Listenelements heraus - 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

Liste()

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

Ein Wert, welcher die Position des aktuellen Elements in der Liste beinhaltet. Das erste Element befindet sich dabei an Position 0, das nächste an 1 und so weiter. Ein Wert 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)

Siehe auch

SelectElement(), ListSize()

Unterstützte OS

Alle