collection.countValues( )

Home

4D v19.8


collection.countValues ( Wert {; EigenschaftsPfad} ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
Wert	Text, Zahl, Boolean, Datum, Objekt, Collection	Wert zum Zählen
EigenschaftsPfad	Text	Objekt EigenschaftsPfad für Werte zum Zählen
Funktionsergebnis	Lange Ganzzahl	Anzahl Vorkommen des Wertes

Beschreibung

Die Funktion collection.countValues( ) gibt an, wie oft Wert in der Collection vorkommt.

Sie können in Wert folgendes übergeben:

Skalaren Wert (Text, Zahl, Boolean, Datum)
Referenz auf Objekt oder Collection

Damit ein Element gefunden wird, müssen Wert und Element vom gleichen Typ sein; die Funktion verwendet den Vergleichsoperator.

Mit dem optionalen Parameter EigenschaftsPfad können Sie Werte in einer Collection mit Objekten zählen. Dazu übergeben Sie in EigenschaftsPfad den Pfad der Eigenschaft, deren Werte sie zählen wollen.

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

Beispiel 1

 C_COLLECTION($col)

 C_LONGINT($vCount)

 $col:=New collection(1;2;5;5;5;3;6;4)

 $vCount:=$col.countValues(5) // $vCount=3

Beispiel 2

 C_COLLECTION($col)

 C_LONGINT($vCount)

 $col:=New collection

 $col.push(New object("name";"Smith";"age";5))

 $col.push(New object("name";"Wesson";"age";2))

 $col.push(New object("name";"Jones";"age";3))

 $col.push(New object("name";"Henry";"age";4))

 $col.push(New object("name";"Gross";"age";5))

 $vCount:=$col.countValues(5;"age") //$vCount=2

Beispiel 3

 C_COLLECTION($numbers)

 C_COLLECTION($letters)

 C_LONGINT($vCount)

 

 $letters:=New collection("a";"b";"c")

 $numbers:=New collection(1;2;$letters;3;4;5)

 

 $vCount:=$numbers.countValues($letters) //$vCount=1