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

EXISTCPO()

ExistCpo( alias, expressao, [indice] ) --> lRet

Valida existência de uma referência.

EXISTCPO()AdvPL
01 · VISÃO GERAL

Visão geral

ExistCpo aprova referência existente e rejeita ausente. A expressão deve ser fornecida sem filial, conforme a ficha; não transportar automaticamente uma chave construída para DBSeek. O índice omitido assume o último definido, segundo esta fonte. A função pode exibir help na rejeição, portanto não é uma consulta silenciosa genérica. O fonte GitHub demonstra a chamada com código/loja de SA1; a proposta usa callback parametrizado sem acessar cadastros reais. Uma validação prévia não resolve sozinha concorrência ou unicidade transacional. (TOTVS, s.d., ref. 1)

02 · SINTAXE

Sintaxe

ExistCpo( alias, expressao, [indice] ) --> lRet

Parâmetros

alias
CaractereObrigatório

Alias da validação.

expressao
CaractereObrigatório

Chave sem filial.

indice
NuméricoOpcional

Índice compatível com a expressão.

Retorno

Verdadeiro quando a regra é atendida; falso na rejeição.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed374()
    Local bValidar := {|cAlias,cChave,nOrdem| ExistCpo(cAlias,cChave,nOrdem)}
    // Chave sem filial, indice compativel; nao avaliar neste exemplo.
Return Nil
Resultado esperado

Bloco preparado sem pesquisa; o sentido do retorno depende da regra de cada função. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Confirmar contexto de validação, índice e mensagens do release. Não confundir os dois retornos lógicos.
  • 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. EXISTCPO(). TDN. Consulta em 2026-10-26.
  2. EURAI. ADVPL/Funcoes/Validacao/ExistCpo.PRW. universo_do_desenvolvedor_site, commit a5c83e9490302bdb4a0fc5a9d92c2d569a60773c. Exemplo analisado. 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