fn:avg 関数

fn:avg 関数は、シーケンス内の値の平均値を戻します。

構文

構文図を読む
>>-fn:avg(sequence-expression)---------------------------------><

sequence-expression
以下のアトミック・タイプのいずれかの項目を含むシーケンス、または空のシーケンス。
  • xs:double
  • xs:decimal
  • xs:integer
  • xs:untypedAtomic
  • xs:dayTimeDuration
  • xs:yearMonthDuration
  • 上記のいずれかのタイプから派生したタイプ

タイプ xs:untypedAtomic の入力項目は、xs:double にキャストされます。

戻り値

sequence-expression が空シーケンスでない場合、戻り値は、sequence-expression に含まれる値の平均です。 戻り値のデータ・タイプは、sequence-expression の項目のデータ・タイプ、または sequence-expression の項目がプロモートされるデータ・タイプと同じです。

sequence-expression が空のシーケンスである場合、空のシーケンスが戻されます。

以下のうち複数のデータ・タイプが sequence-expression に含まれる場合は、エラーが戻されます。
  • xs:dayTimeDuration
  • xs:yearMonthDuration
  • 数値データ・タイプ

例

以下の関数は、シーケンス (5, 1.0E2, 40.5) の平均を戻します。

fn:avg((5, 1.0E2, 40.5))

値は xs:double タイプにプロモートされます。関数は、xs:double 値 4.85E1 を戻し、これは「48.5」としてシリアライズされます。