cChaveCaractereObrigatório
Chave de busca compatível com a ordem ativa.
FUNçãOEm revisão
MsSeek
MsSeek(cChave,[lSoft]) -> lFoundReposiciona registros pela chave da ordem ativa.
Visão geral
Exige área aberta e índice adequado. MsSeek reaproveita informações de posicionamento na thread para buscas repetidas; isso não é cache global entre jobs. A chave precisa respeitar tipos, larguras e componentes do índice, inclusive filial quando aplicável. A referência oficial mistura descrições de aproximação no argumento lSoft e nos exemplos; para exigir correspondência exata, compare os campos da chave após o retorno, em vez de depender apenas do lógico. (Fontes: refs. 1–1.)
Sintaxe
MsSeek(cChave,[lSoft]) -> lFoundParâmetros
lSoftLógicoOpcional
Comportamento de aproximação/posicionamento; conferir no release e nos testes.
Retorno
Lógico usado pelos exemplos oficiais; conferir os campos para validar igualdade completa.
Exemplo comentado
#Include "Protheus.ch"
User Function Ed551()
// Exige area e ordem preparadas; bloco nao invocado.
Local bBuscar := {|cChave| MsSeek(cChave)}
ConOut(ValType(bBuscar))
Return NilResultado esperado
Imprime B. Nenhum cursor é reposicionado pelo bloco não invocado. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.
- Preservar área e ordem, verificar retorno e EOF e comparar os componentes quando a regra exigir igualdade exata. Não usar número de ordem fixo sem conferir o SIX do ambiente.
- Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.
Comentários
Ainda não há comentários aprovados.
Entre com Google ou Microsoft para comentar.