Histórico da Página

Sintaxe

FCOUNT()

Propósito

Retorna a quantidade de campos do arquivo de dados.

Argumentos

Nenhum.

Utilização

A função FCOUNT() é útil em aplicações nas quais se deseja independência da estrutura de dados. Ou seja, aplicações que trabalhem com qualquer arquivo de dados, do qual não se conheça, a priori, a quantidade de campos que possuirão.

Caso não haja um arquivo de dados aberto, a função FCOUNT() retornará zero.

Uma utilização típica da função FCOUNT() é no estabelecimento dos limites superiores para os comandos FOR ... NEXT ou WHILE ... ENDDO, usados em operações que processam um campo do arquivo de dados de cada vez.

Essa função normalmente opera sobre a área de trabalho selecionada. Contudo, se for especificado outro alias, poderá operar sobre esta outra área de trabalho. Por exemplo: <alias>->FCOUNT() fornece a quantidade de campos que possui o arquivo aberto na área de trabalho especificada pelo alias.

Exemplos

FUNCTION LerTrab(cAlias)

LOCAL nCont := 0

FOR nCont := 1 TO (cAlias)->(FCOUNT())

          // Mostra o nome dos campos

          MsgInfo(“Nome do campo do arquivo: “ + (cAlias)->(FIELD(nCont)))

NEXT nCont

RETURN NIL