Usina BRAdvPL Guia
Entrar
← Todos os tópicos
FUNçãOEm revisão

Found

Found() --> lRet

Consulta o resultado da última busca.

FoundAdvPL
01 · VISÃO GERAL

Visão geral

Found informa sucesso da última operação de busca; não realiza uma nova consulta e não prova que o cursor serve para qualquer leitura posterior. O exemplo requer ordem ativa cuja expressão seja ED_COD, com dez posições, e busca a chave fictícia A preenchida até esse tamanho. Consulta Found imediatamente no mesmo contexto e sem outra busca intermediária. Não representa pesquisa de um cadastro padrão nem garante que a chave exista. EDTRB é um alias próprio de teste já aberto; ED_COD, quando usado, é campo caractere de tamanho 10 do esquema didático. (TOTVS, s.d., ref. 1)

02 · SINTAXE

Sintaxe

Found() --> lRet

Retorno

Lógico do sucesso da última busca.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed390()
    Local lBusca
    Local lUltima
    // EDTRB propria; ordem ativa ED_COD de tamanho 10.
    If Select("EDTRB") > 0
        lBusca := EDTRB->(DBSeek(PadR("A",10), .F.))
        lUltima := EDTRB->(Found())
        ConOut(cValToChar(lBusca))
        ConOut(cValToChar(lUltima))
    EndIf
Return Nil
Resultado esperado

Dois indicadores da busca recém-realizada, dependentes da tabela; posição do alias é alterada. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Usar somente tabela própria de teste com estrutura conhecida. Qualificar alias, conferir posição do registro e administrar alterações de contexto conforme o contrato do chamador.
  • Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

Conteúdos relacionados

REFERÊNCIAS
  1. TOTVS. Found. TDN. Consulta em 2026-10-26.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR
0 comentário(s) aprovado(s)

Comentários

Ainda não há comentários aprovados.

Entre com Google ou Microsoft para comentar.

Powered by Usina Docs · Alpha