COUNT (Comando)

  • Artículo

Cuenta los registros de una tabla.

COUNT   [Scope] [FOR lExpression1] [WHILE lExpression2]   [TO VarName]
   [NOOPTIMIZE]

Parámetros

  • Scope
    Especifica el intervalo de registros que se va a incluir en la cuenta. Las cláusulas de alcance son: ALL, NEXT nRecords, RECORD nRecordNumber y REST. Para obtener más información acerca de las cláusulas de alcance, vea el tema Cláusulas de alcance. Los comandos que incluyen Scope sólo actúan sobre la tabla del área de trabajo activa.

    El alcance predeterminado de COUNT es ALL (todos los registros).

  • FOR lExpression1
    Especifica que solamente se cuentan los registros que satisfacen la condición lógica lExpression1. Incluir FOR le permite contar registros condicionalmente y desechar los registros no deseados.

    Rushmore optimizará una consulta COUNT FOR si lExpression1 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, vea SET OPTIMIZE y Usar Rushmore para agilizar el acceso a los datos.

  • WHILE lExpression2
    Especifica una condición por la cual los registros se cuentan siempre y cuando la expresión lógica lExpression2 dé como resultado verdadero (.T.).

  • TO VarName
    Especifica la variable o la matriz en que se almacena la cuenta de registros. Si la variable especificada no existe, Visual FoxPro la creará.

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

Observaciones

COUNT cuenta los registros que estén en el alcance de registros para los que se cumplen las condiciones FOR o WHILE. Si SET TALK está establecido en ON, se mostrará la cuenta de registros.

Si SET DELETE está establecido en OFF, los registros marcados para su eliminación se incluirán en la cuenta.

Para ver una explicación de cómo los valores nulos influyen en COUNT, vea Introducción al lenguaje.

Ejemplo

El ejemplo siguiente cuenta y muestra el número de clientes de París.

CLOSE DATABASES
OPEN DATABASE (HOME(2) + 'Data\testdata')
USE customer  && Opens Customer table

CLEAR
COUNT FOR UPPER(city) = 'PARIS'
DISPLAY FIELDS company, contact FOR UPPER(city) = 'PARIS'

Vea también

CALCULATE | SET DELETED | SET TALK