avg

A média de uma sequência de valores

Descrição

A função fn:avg calcula a média de uma sequência de valores. A sequência $arg pode misturar valores numéricos e sem tipo. Os valores numéricos são promovidos quando preciso para ficarem todos do mesmo tipo. Valores sem tipo são convertidos em xs:double.

A função também serve para durações: a sequência $arg pode ter só valores xs:yearMonthDuration ou só valores xs:dayTimeDuration (mas não uma mistura dos dois).

Cuidado com valores "ausentes" ao usar fn:avg. Veja functx:avg-empty-is-zero para saber mais.

Parâmetros	Descrição
arg:numeric()	a sequência de valores para a média

Exemplos

Os exemplos abaixo usam este documento de entrada:

<xsl:variable name="ordDoc" select="doc('http://www.functx.com/input/order.xml')"/>

<!-- content of order.xml -->
<order num="00299432" date="2006-09-15" cust="0221A">
  <item dept="WMN" num="557" quantity="1" color="beige"/>
  <item dept="ACC" num="563" quantity="1"/>
  <item dept="ACC" num="443" quantity="2"/>
  <item dept="MEN" num="784" quantity="1" color="blue/white"/>
  <item dept="MEN" num="784" quantity="1" color="blue/red"/>
  <item dept="WMN" num="557" quantity="1" color="sage"/>
</order>

XPath	Resultado
avg( (1, 2, 3, 4, 5) )	3
avg( (1, 2, 3, (), 4, 5) )	3
avg((xs:yearMonthDuration('P4M'), xs:yearMonthDuration('P6M') ) )	P5M
avg($ordDoc//item/@quantity)	1.1666666666666667
avg( () )	()
avg($ordDoc//item/@dept)	Error FORG0001

Veja também

• functx:avg-empty-is-zero.

• sum.

• count.