collection.average( )

4D v19.8


collection.average ( {propertyPath} ) -> 戻り値

引数	型	説明
propertyPath	テキスト	計算に使用するオブジェクトプロパティのパス
戻り値	実数, Undefined	コレクションの値の算術平均(平均)

説明

collection.average( ) ファンクションは、コレクションインスタンス内で定義された値の算術平均(あるいは単に平均)を返します。

計算には数値のみが対象となります(他の型の要素は無視されます)。

コレクションがオブジェクトを格納している場合、計算をしたいオブジェクトプロパティをpropertyPath 引数に渡します。

collection.average( ) は以下の場合にはUndefined を返します:

コレクションが空の場合
コレクションに数値が含まれていない場合
コレクション内でpropertyPath 引数で指定したパスが見つからない場合

例題 1

 C_COLLECTION($col)

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

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

例題 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