Descrição
| Desloca para outro registro na tabela corrente.. |
Sintaxe
| dbSkip( <nRegistros> ) |
Parâmetros
| Par | Nome | Tipo | Descrição | Default | Obg | Ref |
| 01 |
nRegistros |
Numérico |
Indica o número de registros que serão deslocados a partir do corrente. Se o valor for positivo, o deslocamento será em direção ao final da tabela, se negativo, ao início da tabela |
1 |
Retorno
| Retorno | Tipo | Descrição |
Exemplo
#INCLUDE "TOTVS.CH"
User Function dbSkip()
dbSelectArea("SA1")
Do While SA1->( !EOF() )
Conout( SA1->A1_COD )
SA1->( dbSkip() )
EndDo
Return( Nil )
Resultado
Informações adicionais
|
Essa função é utilizada para deslocar o ponteiro de registro da tabela para outro registro a partir do registro atual. O deslocamento é lógico, ou seja, leva em consideração a ordem no índice atualmente em uso, e também a expressão de filtro, caso exista |
|
Caso o deslocamento seja negativo (registros anteriores), e passe do início da tabela, o primeiro registro é posicionado e a flag de início da tabela (BOF) é setado |
|
Caso o deslocamento seja positivo (registros posteriores), e passe do final da tabela, a tabela é posicionada no registro "LastRec()+1", e a flag de final de arquivo (EOF) é setada. Neste último caso, se o RDD for "TOPConnect", o Recno() retornado será por convenção "LastRec() + 5000". |
Gostou? Compartilhe com seus amigos e deixe um comentário! 😎