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

PERTENCE()

Pertence(cExpressao) -> lOk

Valida se o conteúdo corrente pertence às opções permitidas.

PERTENCE()AdvPL
01 · VISÃO GERAL

Visão geral

Recebe a expressão com valores permitidos e lê o conteúdo da variável/campo posicionado. A fonte usa VALID de MSGET; não é uma função genérica de busca em array. O exemplo foi adaptado para um caractere e opções 0–4, evitando tratar uma sequência de identificadores como uma lista com separadores não documentados. (Fontes: refs. 1–1.)

02 · SINTAXE

Sintaxe

Pertence(cExpressao) -> lOk

Parâmetros

cExpressao
CaractereObrigatório

Expressão com opções permitidas.

Retorno

Lógico: conteúdo corrente contido na expressão.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed571()
    Local oDlg
    Local cValor := "0"
    // Validar o conteudo corrente, nao um array externo.
    DEFINE MSDIALOG oDlg TITLE "Exemplo" FROM 0,0 TO 100,300 PIXEL
    @ 12,12 MSGET cValor SIZE 40,12 OF oDlg PIXEL VALID Pertence("01234")
    ACTIVATE MSDIALOG oDlg CENTERED
Return Nil
Resultado esperado

O campo aceita as opções documentadas 0–4 na validação; não grava dados. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Testar vazio e valores fora da lista; para chaves com vários caracteres, usar uma validação de lista exata apropriada. Confirmar contexto de edição e não presumir consulta ao banco.
  • 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. PERTENCE%28%29. TDN. Consulta em 2026-10-27.
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