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

Home

 
4D v19.8
collection.findIndex( )

collection.findIndex( ) 


 

collection.findIndex ( {StartAb ;} MethodenName {; param {; param2 ; ... ; paramN}} ) -> Funktionsergebnis 
Parameter Typ   Beschreibung
StartAb  Lange Ganzzahl in Index zum Starten der Suche
MethodenName  Text in Name der Methode zum Aufrufen des Suchergebnis
param  Ausdruck in Parameter zum Übergeben an MethodenName
Funktionsergebnis  Lange Ganzzahl in Index des ersten gefundenen Werts, oder -1, wenn nicht gefunden

Die Methode collection.findIndex( ) gibt den Index des ersten Werts in der Collection zurück, für den der auf jedes Element angewandte MethodenName wahr zurückgibt. Wurde kein Element der Collection mit wahr bewertet, gibt die Methode -1 zurück.

Hinweis: Diese Funktion ändert nicht die ursprüngliche Collection.

collection.findIndex( ) sucht standardmäßig in der gesamten Collection. Optional können Sie in StartAb den Index des Elements ü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).

In MethodenName übergeben Sie den Namen der Methode zum Bewerten der Collection Elemente, zusammen mit den Parametern in param (optional). MethodenName kann den Suchlauf mit oder ohne die Parameter durchführen. Diese Methode empfängt einen Parameter Object in $1 und muss $1.result für das erste zutreffende Element auf wahr setzen.

MethodenName empfängt folgende Parameter:

  • in $1.value: Elementwert zum Bewerten
  • in $2: param
  • in $N...: param2...paramN

MethodenName setzt folgende Parameter:

  • $1.result (boolean): wahr, wenn der Elementwert zur Suchbedingung passt.
  • $1.stop (boolean, optional): wahr, um Aufruf der Methode zu stoppen. Der zurückgegebene Wert ist der letzte bewertete Wert.

Die Position des ersten Stadtnamens in der Collection finden:

 C_COLLECTION($c)
 C_LONGINT($val2;$val3)
 $c:=New collection
 $c.push(New object("name";"Cleveland";"zc";35049))
 $c.push(New object("name";"Blountsville";"zc";35031))
 $c.push(New object("name";"Adger";"zc";35006))
 $c.push(New object("name";"Clanton";"zc";35046))
 $c.push(New object("name";"Clanton";"zc";35045))
 $val2:=$c.findIndex("FindCity";"Clanton") // $val2=3
 $val3:=$c.findIndex($val2+1;"FindCity";"Clanton") //$val3=4

Der Code der Methode FindCity lautet:

 C_OBJECT($1)
 C_TEXT($2)
 $1.result:=$1.value.name=$2



Siehe auch 

collection.find( )

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: Collections
Nummer: 805256

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)