Descrição
| 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! 😎