Descrição
(DADOS) EXISTCHAV - 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
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! 😎
