4D v18

collection.indexOf( )

Home

 
4D v18
collection.indexOf( )

collection.indexOf( )  


 

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).

 C_COLLECTION($col)
 $col:=New collection(1;2;"Henry";5;3;"Albert";6;4;"Alan";5)
 $i:=$col.indexOf(3) //$i=4
 $i:=$col.indexOf(5;5) //$i=9
 $i:=$col.indexOf("al@") //$i=5
 $i:=$col.indexOf("Hello") //$i=-1



Siehe auch 

collection.lastIndexOf( )

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: Collections

Dieser Befehl kann in preemptive Prozessen laufen

 
SEITENINHALT 
 
GESCHICHTE 

 
ARTIKELVERWENDUNG

4D Programmiersprache ( 4D v18)