collection.countValues( )

4D v19.8


collection.countValues ( valor {; rutaProp} ) -> Resultado

Parámetro	Tipo	Descripción
valor	Texto, Número, Booleano, Fecha, Objeto, Collection	Valor a contar
rutaProp	Texto	Ruta de la propiedad del objeto para los valores a contar
Resultado	Entero largo	Número de ocurrencias del valor

Descripción

La función collection.countValues( ) devuelve el número de veces que se encuentra el valor en la colección.

Puede pasar en valor:

un valor escalar (texto, número, booleano, fecha),
un objeto o una referencia de colección.

Para un elemento a encontrar, el tipo de valor debe ser equivalente al tipo del elemento; la función usa el operador de igualdad.

El parámetro opcional rutaProp le permite contar valores dentro de una colección de objetos: pasar en rutaProp la ruta de la propiedad cuyos valores desea contar.

Nota: esta función no modifica la colección original.

Ejemplo 1

 C_COLLECTION($col)

 C_LONGINT($vCount)

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

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

Ejemplo 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

Ejemplo 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