Descrição
dbSeek [AS] - Localiza um registro com determinado valor da expressão de chave de índice...
|
Sintaxe
| dbSeek( <cExp>, <lSoftSeek>, <lUltimo> ) |
Parâmetros
| Par |
Nome |
Tipo |
Descrição |
Default |
Obg |
Ref |
01
|
cExp
|
Caracter
|
Indica o valor da chave que será encontrada
|
|
|
|
| 02 |
lSoftSeek
|
Boolean
|
Indica se, verdadeiro (.T.), posiciona no primeiro registro com expressão de chave maior que o valor procurado
|
.F. |
|
|
| 03 |
lUltimo
|
Boolean
|
Parâmetro não suportado pela linguagem AdvPL. Mantido por compatibilidade
|
|
|
|
Retorno
| Retorno |
Tipo |
Descrição |
| lRet |
Boolean
|
Retorna verdadeiro (.T.), se encontrar um registro com o valor especificado; caso contrário, falso (.F.).
|
Exemplo
#INCLUDE "TOTVS.CH"
User Function dbSeek()
dbSelectArea('SA1')
If SA1->( dbSeek( xFilial('SA1') + '000001' + '0001' ) )
MsgInfo( 'Encontrou', 'UniversoADVPL' )
Endif
Return( Nil )
Resultado
Informações adicionais
|
Antes de chamar a função DBSeek(), deve-se certificar de que existe uma ordem ativa no momento com os campos que se deseja pesquisar o valor. Se a expressão possuir apenas um campo numérico, o primeiro parâmetro <xExp> deve ser do tipo numérico, mas nos demais casos deve-se utilizar um valor do tipo caracter para este parâmetro (mesmo que sejam apenas dois campos numéricos ou do tipo data).
|
|
Quando o segundo parâmetro <lSoftSeek> for especificado como verdadeiro (.T.), mesmo que a expressão pesquisada não encontrar nenhum registro com este valor, a tabela será posicionada no próximo valor maior que o especificado no primeiro parâmetro <xExp>, mas mesmo posicionando no próximo valor essa função retornará falso (.F.) (pois não encontrou).Quando não for especificado este valor ou estiver configurado falso (.F.) e falhar o valor da pesquisa, a tabela será posicionada em LastRec +1 e será setada a flag de EOF.Se o terceiro parâmetro <lUltimo> for especificado com valor verdadeiro (.T.), a função posiciona a tabela no último registro com o valor, ou falso (.F.), será posicionada na primeira ocorrência.
|
Gostou? Compartilhe com seus amigos e deixe um comentário! 😎