(DADOS) EXISTCHAV

(DADOS) EXISTCHAV
Author: Eurai
Inclusão: 01/01/2016
Alteração: 27/07/2021

Descrição

VERIFICA SE O CONTEÚDO ESPECIFICADO EXISTE NO ARQUIVO DE DADOS.

 

Sintaxe

EXISTCHAV( <CALIAS>, <CEXPRESSAO>, <NINDICE>, <CHELP> )

 

Parâmetros


Par Nome Tipo Descrição Default Obg Ref
01
CALIAS Caracter Alias do arquivo de dados no qual a informação será pesquisada e validada   X  
02 CEXPRESSAO Caracter Índice que será utilizado para a pesquisa da expressão no arquivo de dados. Sem xFilial      
03 NINDICE Numérico Esse argumento é opcional. Caso não seja informado, a função assume que será utilizado o primeiro índice do arquivo de dados 1    
04 CHELP Caracter Nome do help padrão do Protheus que será exibido para o usuário. Esse argumento é opcional         

 

Retorno

Retorno Tipo Descrição
lRet Boolean
Retorna verdadeiro (.T.). Caso não exista, retorna falso (.F.) e exibe um help informando a ocorrência

 

Exemplo

#INCLUDE "TOTVS.CH"

User Function ExistChav()

MsgInfo( 'ExistChav: ' + cValtoChar( ExistChav("SA1", '000001' + '01', 1, "EXISTCLI") ) + CRLF + ;
'ExistChav: ' + cValtoChar( ExistChav("SA1",'ZZDD11' + 'ZZ', 1, "EXISTCLI") ) ;
 , 'UniversoADVPL' )

Return( Nil )

Resultado
existchav_-_resultado_01  

 

 

Informações adicionais

As funções ExistCpo() e ExistChav() parecem semelhantes. Porém, a função ExistCpo() verifica uma chave estrangeira, ou seja, verifica se um código existe em outro arquivo de dados, enquanto que a função ExistChav() verifica uma chave única, ou seja, verifica se um código já existe no próprio arquivo de dados que está sendo manipulado

 

 

 

 

 

Gostou? Compartilhe com seus amigos e deixe um comentário! 😎  

 

 

 

 

 

 

 

Esse conteúdo te ajudou? Ajude o canal com doação
Compartilhar
Comentários