FCOUNT()
 Retorna a quantidade de campos no arquivo (.dbf) corrente
------------------------------------------------------------------------------

 Sintaxe

     FCOUNT() --> nCampos

 Retorno

     FCOUNT() retorna a quantidade de campos no arquivo de banco de dados
     aberto na área de trabalho corrente na forma de um valor numérico
     inteiro.  Caso nao haja nenhum arquivo de banco de dados aberto,
     FCOUNT() retorna zero.

 Descriçao

     FCOUNT() é uma funçao de tratamento de banco de dados.  Ela é útil em
     aplicaçoes que contêm programas independentes de dados os quais podem
     operar em qualquer arquivo de banco de dados.  Nestes incluem-se
     programas gerais para importar e exportar dados e programas de
     relatórios.  Normalmente, utiliza-se FCOUNT() para estabelecer o limite
     superior de um laço FOR...NEXT ou DO WHILE que processa um único campo
     por vez.

     O padrao é que a funçao FCOUNT() opere na área de trabalho
     correntemente selecionada.  Pode-se fazê-la operar numa área de
     trabalho nao selecionada se esta for especificada em uma expressao
     alias.

 Exemplos

       A seguir FCOUNT() retorna a quantidade de campos nas áreas de
        trabalho corrente e nao selecionada:

        USE Sales NEW
        USE Customer NEW
        ? FCOUNT()                       // Resulta: 5
        ? Sales->(FCOUNT())              // Resulta: 8

       Este exemplo usa FCOUNT() para declarar um vetor a ser
        carregado com informaçoes sobre campos:

        LOCAL aFields := ARRAY(FCOUNT())
        AFIELDS(aFields)

       Este exemplo utiliza a funçao FCOUNT() como o limite superior
        de um laço FOR na lista de campos da área de trabalho corrente:

        LOCAL nField
        USE Sales NEW
        FOR nField := 1 TO FCOUNT()
           ? FIELD(nField)
        NEXT

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

See Also: AFIELDS()* FIELD() TYPE()