SHA1 (Secure Hash Algorithm) gera o hash (ou digest) de um conteúdo, com base no algoritmo definido em FIPS PUB 180-1 published April 17, 1995.
Sintaxe
SHA1( < cContent >, [ nRetType ] )
Parâmetros
Nome | Tipo | Descrição | Obrigatório | Referência |
---|---|---|---|---|
cContent | caractere | Indica a string que contém os dados no qual será gerado o hash. | X | |
nRetType | numérico | Indica o tipo de retorno do digest. Quando informado 1 (um) retorna uma string no formato RAW_DIGEST (sequência de 20 bytes ASCII); quando informado 2 (dois) retorna uma string no formato HEX_DIGEST (sequência hexadecimal de 40 caracteres). Caso não informado, o valor padrão é 2 (dois). |
Retorno
Nome | Tipo | Descrição |
---|---|---|
cDigest | caractere | Retorna o hash (ou digest) do conteúdo informado. |
Observações
A geração de um HASH (SHA1 e/ou MD5) normalmente é utilizada para verificar se o conteúdo sofreu alguma alteração, por exemplo, após ser enviado através de um e-mail, Web Service ou algum outro tipo de transporte ou armazenamento.
Exemplos
User Function tstSHA1() Local sStr := "0123456789abcdefghijklmnopqrstuvxz" Local sOut := "" sOut := SHA1( sStr ) varinfo( "1", sStr ) varinfo( "2", sOut ) Return
Abrangência
Advanced Protheus 6.09 , Advanced Protheus 7.10 , Microsiga Protheus 8.11 , Protheus 10