Usina BRAdvPL Guia
Entrar
← Todos os tópicos
FUNçãOEm revisão

DBSkip

DBSkip( [nReg] ) --> Nil

Avança ou recua na sequência lógica dos registros.

DBSkipAdvPL
01 · VISÃO GERAL

Visão geral

DBSkip considera ordem ativa, filtro e configuração de registros excluídos. O deslocamento padrão é um; números negativos recuam. Após ultrapassar o fim, EOF indica ausência de registro válido; não ler campos nessa posição. Ao recuar além do início, BOF sinaliza o limite. Não usar números mágicos de RecNo como substitutos desses testes: convenções variam por RDD. EDTRB identifica exclusivamente uma tabela própria de teste, já aberta com a estrutura e os direitos necessários; os exemplos não se destinam a tabelas padrão. (TOTVS, s.d., ref. 1)

02 · SINTAXE

Sintaxe

DBSkip( [nReg] ) --> Nil

Parâmetros

nReg
NuméricoOpcional

Deslocamento lógico; padrão 1.

Retorno

Nil; não é um indicador lógico de sucesso.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed340()
    If Select("EDTRB") > 0
        If !EDTRB->(Eof())
            EDTRB->(DBSkip(1))
            // Verificar novamente depois do movimento.
            ConOut(cValToChar(!EDTRB->(Eof())))
        EndIf
    EndIf
Return Nil
Resultado esperado

Informa se existe registro válido depois de um avanço, sem expor campos. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Conferir RDD, alias e operações pendentes. Navegação pode efetivar atualizações; preservar contexto conforme o contrato do chamador e tratar erros na rotina completa.
  • Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

Conteúdos relacionados

REFERÊNCIAS
  1. TOTVS. DBSkip. TDN. Consulta em 2026-10-26.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR
0 comentário(s) aprovado(s)

Comentários

Ainda não há comentários aprovados.

Entre com Google ou Microsoft para comentar.

Powered by Usina Docs · Alpha