dbSeek [AS]
Autor: Eurai Criado: 01/01/2016 Atualizado: 25/04/2025Descriçã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! 😎
Discussão (0)
Sem comentários ainda
Realize o LOGIN no site para poder comentar