collection.average( )

4D v19.8


collection.average ( {rotaProp} ) -> Resultado

Parâmetro	Tipo	Descrição
rotaProp	Texto	Rota de propriedade objeto para ser usado para cálculo
Resultado	Real, Undefined	Média aritmética dos valores da coleção

Descrição

A função collection.average( ) devolve a média aritmética dos valores definidos na instância de coleção.

Só são levados em consideração elementos numéricos para o cálculo (são ignorados outros tipos de elementos).

Se a coleção contiver objetos, passe o parâmetro rotaProp para indicar a propriedade do objeto a ser considerado.

collection.average( ) devolve Indefinido se:

a coleção estiver vazia,
a coleção não contiver elementos numéricos,
rotaProp não se encontra na coleção.

Exemplo 1

 C_COLLECTION($col)

 $col:=New collection(10;20;"Monday";True;6)

 $vAvg:=$col.average() //12

Exemplo 2

 C_COLLECTION($col)

 $col:=New collection

 $col.push(New object("name";"Smith";"salary";10000))

 $col.push(New object("name";"Wesson";"salary";50000))

 $col.push(New object("name";"Gross";"salary";10500))

 $vAvg:=$col.average("salary") //23500