Share via

AVERAGE (Comando)

  • Artículo

Calcula la media aritmética de expresiones o de campos numéricos.

AVERAGE [ExpressionList]   [Scope] [FOR lExpression1] [WHILElExpression2]
   [TO VarList | TO ARRAY ArrayName]   [NOOPTIMIZE]

Parámetros

  • ExpressionList
    Especifica las expresiones cuya media se calcula. ExpressionList puede ser una lista de campos de la tabla separados por comas o expresiones numéricas que utilicen campos de la tabla.

  • Scope
    Especifica el registro o el intervalo de registros que se desea incluir en el promedio. Sólo se calcula el promedio de aquellos registros que estén dentro del intervalo especificado por el alcance. Las cláusulas de alcance son: ALL, NEXT nRecords, RECORD nRecordNumber y REST. El alcance predeterminado para AVERAGE es ALL.

    Los comandos que incluyen Scope sólo actúan sobre la tabla del área de trabajo activa.

  • FOR lExpression1
    Especifica una condición por la que sólo se incluyen aquellos registros que satisfagan la condición lógica lExpression. Este argumento permite filtrar los registros no deseados.

    Rushmore optimiza una consulta AVERAGE FOR si lExpression es una expresión optimizable. Para obtener el máximo rendimiento, utilice una expresión optimizable en la cláusula FOR. Si desea obtener más información acerca de las expresiones optimizables con Rushmore, vea SET OPTIMIZE y Usar Rushmore para agilizar el acceso a los datos.

  • WHILE lExpression2
    Especifica que, siempre y cuando la expresión lógica lExpression2 produzca como resultado de su evaluación el valor verdadero (.T.), los registros se incluirán en el promedio.

  • TO VarList
    Especifica la lista de variables o elementos de matriz donde se almacena el resultado del promedio.

  • TO ARRAY ArrayName
    Especifica la matriz de una dimensión donde se almacena el resultado del promedio. La matriz de una dimensión puede crearse antes de ejecutar AVERAGE.

    Si la matriz que se incluye en AVERAGE no existe, Visual FoxPro la creará automáticamente. Si la matriz existe pero no es suficientemente grande para contener todos los resultados, Visual FoxPro aumenta su tamaño automáticamente para dar cabida a la información.

  • NOOPTIMIZE
    Desactiva la optimización Rushmore de AVERAGE. Si desea obtener más información, vea SET OPTIMIZE y Usar Rushmore para agilizar el acceso a los datos.

Observaciones

Se calcula el promedio de todos los campos numéricos de la tabla seleccionada, a menos que incluya una lista opcional de expresiones. El resultado aparecerá en la pantalla si SET TALK está establecido en ON. Si SET HEADINGS está establecido en ON, los nombres de campo o la expresión en que se utilicen los nombres de campo aparecerán encima del resultado.

Ejemplo

CLOSE DATABASES
OPEN DATABASE (HOME(2) + 'Data\testdata')
USE orders  && Open order table

CLEAR
AVERAGE Order_Amt  && Calcuate averages of all orders
AVERAGE Order_Amt TO gnAvg  && Store average to memory variable
? 'Average order amount: '
?? gnAvg  && Display the average again

Vea también

CALCULATE | DIMENSION | SET HEADINGS | SUM | Usar Rushmore para agilizar el acceso a los datos | SET OPTIMIZE