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」としてシリアライズされます。
