RECCOUNT()

Sintaxe

RECCOUNT()

Propósito

Determina a quantidade de registros existentes no arquivo.

Argumentos

Nenhum.

Utilização

A função RECCOUNT() fornece o número do último registro físico do arquivo de dados aberto na área de trabalho selecionada. Caso não exista nenhum arquivo de dados aberto na área de trabalho selecionada ou se o arquivo estiver vazio, a função retorna zero.

Uma utilização típica da função RECCOUNT() é a apresentação da quantidade de registros de um arquivo de dados para o usuário, principalmente em relatórios. Dessa forma, o usuário consegue acompanhar o progresso da impressão.

A função RECCOUNT() está obsoleta, tendo sido mantida apenas por questões de compatibilidade. Ela deve ser substituída pela função LASTREC(), cuja funcionalidade é idêntica.

Dicas

A função RECCOUNT() normalmente opera sobre a área de trabalho selecionada. Contudo, poderá operar sobre outro alias, caso seja especificado, conforme o seguinte exemplo: <alias>->RECCOUNT() fornece o número do último registro físico do arquivo de dados aberto na área de trabalho especificada pelo alias.

Exemplos

TRB->(RECCOUNT())

No exemplo acima, a função retornará a quantidade de registros do arquivo de dados aberto na área de trabalho TRB.