COUNT
 Totaliza o número de registros e coloca o resultado numa variável
------------------------------------------------------------------------------

 Sintaxe

     COUNT TO <idVar>
        [<abrangência>] [WHILE <lCondiçao>] [FOR <lCondiçao>]

 Argumentos

     TO <idVar> identifica a variável à qual será atribuído o resultado
     do comando COUNT.  Uma variável que nao existe ou nao é visível é
     criada como uma variável do tipo privada cuja abrangência é o
     procedimento corrente.

     <abrangência> é a parte do arquivo de dados corrente onde o comando
     COUNT atuará.  O padrao é todos (ALL) os registros.

     WHILE <lCondiçao> especifica o conjunto de registros que atendem a
     condiçao do registro corrente até que a condiçao seja falsa.

     FOR <lCondiçao> especifica o conjunto de registros condicional para
     o comando COUNT dentro da abrangência.

 Descriçao

     O comando COUNT totaliza o número de registros da área de trabalho
     corrente que atendem as condiçoes e abrangência especificadas.  O
     resultado é entao alocado à variável em questao.<idVar> pode ser uma
     variável de qualquer classe de armazenamento, inclusive um campo.

 Exemplos

       Este exemplo demonstra um COUNT do campo Branches em
        Sales.dbf:

        USE Sales NEW
        ? LASTREC()                                 // Resulta: 84
        COUNT TO nBranchCnt FOR Branch == 100
        ? nBranchCnt                                // Resulta: 4

       Este exemplo totaliza o número de registros em Sales.dbf,
        cujo campo Branch tem o valor de 100, e atribui o resultado ao campo
        Count no Branch.dbf para branch == 100:

        USE Branch INDEX Branch NEW
        SEEK 100
        USE Sales INDEX SalesBranch NEW
        SEEK 100
        COUNT TO Branch->Count WHILE Branch == 100

 Arquivos:  Biblioteca CLIPPER.LIB.
 To download this example - click here.

See Also: AVERAGE SUM TOTAL DBEVAL()