Dies ist die alte 4D Dokumentations-Website. Die neue und aktualisierte Dokumentation finden Sie unter developer.4d.com
- 4D Programmiersprache
-
- Collections
-
-
Über Collections
-
Typkonvertierung zwischen Collections und 4D Arrays
-
collection.length
-
collection.average( )
-
collection.clear( )
-
collection.combine( )
-
collection.concat( )
-
collection.copy( )
-
collection.count( )
-
collection.countValues( )
-
collection.distinct( )
-
collection.equal( )
-
collection.every( )
-
collection.extract( )
-
collection.fill( )
-
collection.filter( )
-
collection.find( )
-
collection.findIndex( )
-
collection.indexOf( )
-
collection.indices( )
-
collection.insert( )
-
collection.join( )
-
collection.lastIndexOf( )
-
collection.map( )
-
collection.max( )
-
collection.min( )
-
collection.orderBy( )
-
collection.orderByMethod()
-
collection.pop( )
-
collection.push( )
-
collection.query( )
-
collection.reduce( )
-
collection.remove( )
-
collection.resize( )
-
collection.reverse( )
-
collection.shift( )
-
collection.slice( )
-
collection.some( )
-
collection.sort( )
-
collection.sum( )
-
collection.unshift( )
-
ARRAY TO COLLECTION
-
COLLECTION TO ARRAY
-
New collection
-
New shared collection
-
collection.findIndex( )
| collection.findIndex ( {StartAb ;} MethodenName {; param {; param2 ; ... ; paramN}} ) -> Funktionsergebnis | ||||||||
| Parameter | Typ | Beschreibung | ||||||
| StartAb | Lange Ganzzahl |
|
Index zum Starten der Suche | |||||
| MethodenName | Text |
|
Name der Methode zum Aufrufen des Suchergebnis | |||||
| param | Ausdruck |
|
Parameter zum Übergeben an MethodenName | |||||
| Funktionsergebnis | Lange Ganzzahl |
|
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=4Der Code der Methode FindCity lautet:
C_OBJECT($1)
C_TEXT($2)
$1.result:=$1.value.name=$2
Produkt: 4D
Thema: Collections
Nummer:
805256
Erstellt: 4D v16 R6
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)
