Histórico da Página

Sintaxe

DbSkip(<expressão numérica>)

Propósito

Move o cursor do registro posicionado para o próximo registro (ou anterior, dependendo do argumento), de acordo com o índice ativo para a área de trabalho.

Argumentos

<expressão caracter>

É a quantidade de registros que devem ser percorridos. Ou seja, define em quantos registros o cursor será deslocado.

Caso o usuário não informe esse argumento, o padrão utilizado será 1. Ou seja, se avançará um registro.

Dicas

Em ambientes com bancos de dados relacionais (SQL, Oracle, etc.) deve-se evitar a utilização da função para movimentar o cursor nos registros anteriores, expressa pela sintaxe dbSkip(-1), pois essa ação pode gerar lentidão no processamento.

Exemplos

Neste exemplo, mostraremos o avanço de registros.

dbSelectArea(“SA1”)

dbSetOrder(2)     // A1_FILIAL + A1_NOME

dbGoTop()          // Posiciona o cursor no início da área de trabalho ativa

WHILE !EOF()     // Executa enquanto o cursor da área de trabalho ativa não indicar fim de arquivo

          MsgInfo(“Você está no cliente: “ + A1_NOME)

          dbSkip()

ENDDO

Neste exemplo mostraremos o retrocesso dos registros.

dbSelectArea(“SA1”)

dbSetOrder(2)         // A1_FILIAL + A1_NOME

dbGoBotton()          // Posiciona o cursor no final da área de trabalho ativa

WHILE !BOF()     // Executa enquanto o cursor da área de trabalho ativa não indicar início de arquivo

          MsgInfo(“Você está no cliente: “ + A1_NOME)

          dbSkip(-1)

ENDDO