Tempo de leitura: 2 minutos
A função Pertence em ADVPL verifica se o conteúdo de um campo ou variável pertence a uma expressão informada como parâmetro. Ela é uma das funções de validação em ADVPL.
Sintaxe:
Pertence(cExpr)
Parâmetro(s):
Retorno:
Utilização
Essa função normalmente é utilizada em campos que possuem a opção de combo. Ou seja, várias opções disponíveis dentro de uma lista pré-determinada.
Exemplo da função Pertence em ADVPL:
/*{Protheus.doc} User Function fPerten
(Essa função tem por finalidade mostrar a função de validação Pertence em ADVPL)
@?type Function
@?author Adilio Costa
@?since 28/03/2023
@?version 1.0
@?Inscreva-se no Blog ProtheusAdvpl:
https://www.protheusadvpl.com.br
@?Inscreva-se no Canal ProtheusAdvpl:
https://www.youtube.com/protheusadvpl
@?Siga-nos no Instagram:
https://www.instagram.com/protheusadvpl
@?Conheça os Cursos e Formações do Protheus:
https://cursos-e-formacoes-protheusadvpl.gr-site.com/
@Participe de nossas comunidades no WhatsApp:
-Comunidade Protheus Backoffice:https://chat.whatsapp.com/KMUIAjwZ6EZ6eAHsLkPTyb
-Comunidade Protheus-RH:https://chat.whatsapp.com/L5dUyAna6xU4ylG5DUgfOW
-Comunidade Protheus-Programação:https://chat.whatsapp.com/LsD6z0apdqKHlOz67bcaEn
-Comunidade Protheus-Framework:https://chat.whatsapp.com/BzUFpjaSnTC3vtsfa77jmG
|Se esse conteúdo foi útil pra você nos ajude divulgando
ele e nossas redes sociais!!|
*/
User Function fPerten()
Local aArea := FWGetArea()
Local cCNPJ
//Usando a função Pertence para validar um conteúdo de um campo
@ 010,050 MSGET cCNPJ SIZE 55,11 OF oDlg PIXEL PICTURE “@R 99.999.999/9999-99”;
Valid Pertence(“01234”)
//Verificando se a letra "A" pertence a expressão "ProtheusAdvpl"
If Pertence("ProtheusAdvpl", "A")
FWAlertSuccess("O valor A foi encontrado na expressão ProtheusAdvpl", "Função Pertence")
else
FWAlertError("O valor A não foi encontrado na expressão ProtheusAdvpl", "Função Pertence")
EndIf
FWRestArea(aArea)
Return
Nesse exemplo, o conteúdo da variável não pode ser diferente de “0”, “1”, “2”, “3” ou “4”. Caso seja diferente, o sistema não permite pois a função Pertence irá retornar falso(.F.).
Bem, finalizamos mais um post aqui no blog. Espero que você tenha entendido, qualquer dúvida nos envie um e-mail para adiliocosta@protheusadvpl.com.br. Grande abraço e fica com Deus.
Links de referência(s):
