Die Funktion collection.indexOf( ) sucht in den Collection Elementen nach dem Ausdruck zuSuchen und gibt den Index des ersten Auftretens zurück, oder -1, wenn dieser nicht gefunden wurde.
Hinweis: Diese Funktion ändert nicht die ursprüngliche Collection.
In zuSuchen übergeben Sie den gesuchten Ausdruck in der Collection. Sie können folgendes übergeben:
- Skalaren Wert (Text, Zahl, Boolean, Datum)
- Wert Null
- Referenz auf ein Objekt oder eine Collection
zuSuchen muss exakt zum gesuchten Element passen. Es gelten dieselben Regeln wie für den Gleichheitsoperator (siehe Vergleichsoperatoren).
Optional können Sie in StartAb den Collection Index übergeben, bei dem die Suche starten soll.
- Ist StartAb >= Länge der Collection, wird -1 zurückgegeben, d.h. die Collection wird nicht durchsucht.
- Ist StartAb < 0, wird es als Versatz vom Ende der Collection gewertet (StartAb:=StartAb+Länge).
Hinweis: Auch wenn StartAb negativ ist, wird die Collection weiterhin von links nach rechts durchsucht. - Ist StartAb = 0, wird die gesamte Collection durchsucht (Standard).