Histórico da Página

Sintaxe

RECNO()

Propósito

Retorna o número do registro corrente de uma área de trabalho.

Argumentos

Nenhum.

Utilização

Os registros dos arquivos de dados do AdvPL são enumerados de 1 até o último registro físico, de acordo com a ordem cronológica em que foram incluídos.

A função RECNO() é utilizada para se obter o número do registro do arquivo de dados em uso no qual está posicionado o apontador de registros da área de trabalho selecionada.

Cada área de trabalho mantém um apontador de registros, posicionado no registro atual do arquivo de dados que nela estiver aberto.

Quando um arquivo não contiver registros, a função RECNO() retornará 1, a função LASTREC() retornará zero e as funções EOF() e BOF() fornecerão verdadeiro (.T.).

Dicas

O valor do número do registro fornecido pela função RECNO() pode ser armazenado em uma variável numérica.

Com base na posição obtida pela função RECNO(), pode-se posicionar o ponteiro diretamente nesse registro por meio da função dbGoto().

Exemplos

Neste exemplo, o ponteiro está posicionado no quinto registro do Cadastro de Clientes. Com base nisso, a instrução SA1->(RECNO()) retorna 5.