Dies ist die alte 4D Dokumentations-Website. Die neue und aktualisierte Dokumentation finden Sie unter developer.4d.com

Home

 
4D v19.8
collection.indexOf( )

collection.indexOf( ) 


 

collection.indexOf ( zuSuchen {; StartAb} ) -> Funktionsergebnis 
Parameter Typ   Beschreibung
zuSuchen  Ausdruck in Element, nach dem in der Collection gesucht wird
StartAb  Lange Ganzzahl in Index, bei dem die Suche startet
Funktionsergebnis  Lange Ganzzahl in Index des ersten Auftretens von ZuSuchen in der Collection, -1 wenn nicht gefunden

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
Nummer: 805255

Dieser Befehl kann in preemptive Prozessen laufen

 
SEITENINHALT 
 
GESCHICHTE 

Erstellt: 4D v16 R6

 
ARTIKELVERWENDUNG

4D Programmiersprache ( 4D v19)
4D Programmiersprache ( 4D v19.1)
4D Programmiersprache ( 4D v19.4)
4D Programmiersprache ( 4D v19.5)
4D Programmiersprache ( 4D v19.6)
4D Programmiersprache ( 4D v19.7)
4D Programmiersprache ( 4D v19.8)